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PREFACE 


This manual is intended for the assembly language programmer. It covers the 


— Assembler environment, 

— Assembly language, 

— Macro language, 

— Handling of the assembler, 

— Messages, error messages and warnings of the assembler. 


A description of the Post-Assembly Diagnostic Routine (ADIAG) is also 
included. 


The present manual is designed as a reference book. The reader is supposed 
to be familiar with the assembly language. 


The differences between this and the obsolete version are detailed in the 
List of Amendments. 


Literature references are specified in the text in abbreviated form. The 
complete title of every publication referred to is contained in the list 
of "References". The corresponding System Reference Guide is listed in 
addition. | 


To help us continue improving our publications, please send us your comments, 
requests and suggestions using the reply forms provided at the back. 
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List of amendments 


C LIST OF AMENDMENTS 1 


The following amendments have been made since publication of the 
Revision September 1985 (Assembler V29.1B), 

and incorporated in the 
Edition May 1987 (Assembler V29.1C) 


The most important amendments are: 

e PLAM source member name > 8 characters 
e Monitor job variables support 

e EDT fullscreen mode (ADIAG) 


© e Revised description of dummy registers 


The following table lists the amendments in detail: 


fied |ted 
2-2 IOPACKAGE, IOSTART, ILA AES 
to be loaded unshared X 
Eu — — — . 
me Au. 
me еы — 
1 
ьо м — — 1H. 
T 
n το — d 
эю EN 
pue -— it: 
3-80 Text changed in the last but one paragraph aii. 
preceding the first example 
узе | Now tot for amy resisters ΕἼ ΝΕ 
S 
3-98 Last 4 notes: new text added M^ Se 


Assembler V29.1C, U62-J-255-6-7600 


List of amendments 


Page 


4-1 


6-7/8 
6-8. 


6-10 


6-22 
6-22 ff 


All-lff 


Topic modi - 
fied 

Change: There are four types of | 

macro instructions 


Notes on macro library 


Text changed? Four formats xig 


4th paragraph: redefined on 


Error code ... 3 digits 
ΜΝΟΤΕΧ 


Four types of macro instructions 


Reference to 4.7.4 ir 


New text on system variable symbols 


Reference to A.9, item 10 (Default Values) 


Text amended in first paragraph 


LCLA inserted 


Note: Multiple start using SAVLST option 
EDT full-screen mode 


ATXREF + INSTR = SETI 


SAVLST, multiple start 
"+" {Libr(name) } 


SOURCE option remarks 


Reference to LMS conventions 

Note: Task switch as of 29.0 

PARAM CARD=YES 

Example 1 new, examples 2 + 3 amended 


Text SOURCE PROGRAM 


Error messages: 

LOCKED, NEXT ATTEMPT AFTER 6 SECONDS 
OPEN ERROR OD99 

Text after SOURCE LIBRARY (7.) 


Note on error flags 


Monitor job variable support 


Appendix А. 11: Dummy register examples 
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Introduction 


© 1 ΠΌΝΤΟΝ 


The assembly language is a machine-oriented, symbolic programming language 
which expedites the writing of programs for execution in the operating 
system BS2000. 


Machine instruction statements are a one-for-one symbolic representation 

of actual machine instructions. The assembler produces an equivalent machine 
instruction in the object program for each machine instruction statement in 
the source program. 


Assembly instruction statements provide auxiliary functions that assist the 
programmer in? 


— checking and documenting his programs, 
— controlling the assigment of storage addresses, 

C — program sectioning and linking, 
— defining data and storage fields, 
- controlling the assembly system itself. 
Assembly instruction statements specify the auxiliary functions to be 
performed during the assembly and, with a few exceptions, do not result 
in the generation of any machine language code during the assembly. 
Macro instruction statements enable the assembler to retrieve, during the 
assembly, routines which have already been coded (written in assembly 
language), to modify these routines according to information supplied in 
the macro instruction, and insert the generated source statements in place 


of the macro statement. 
The resulting source program is translated into machine language. 
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ç e ASSEMBLER ENVIRONMENT 


2-1 CONFIGURATION 


The minimum configuration for running the assembler is the same as the 
minimum specified for the Executive. 


In general, the assembler is file-oriented. Utility files are used as the 
assembly work devices. 


2-2 BATCHED ASSEMBLIES 


Several assemblies may be processed once the assembler has been loaded. 
Multiple assemblies are achieved by beginning another source module 
immediately following the END card from the previous source module. Commands 
can not be issued between two source programs. If any command is given, the 
assembler must be recalled. 


2-3 ORGANISATION OF THE ASSEMBLER 


The assembler is composed of ten modules which have the functions indicated: 


ICOMMON Performs initialization, contains all private areas. 
ICONTROL Initializes the file tables for each pass, calls each pass 
of the assembler. 
ç IOPACKGE All L/O subroutines are contained in this module. 
ISLU Reads in source language and performs update processing. 
IPASS1 Reformats the input statement into compressed form, stores 


macro definitions, searches macro libraries. 
IPASS2 Expands macro calls. 


IPASS3 Determines the number of bytes of memory for the assembled 
program, builds a symbol table, formats DC constants. 


IPAS3A Relocates all symbols, builds the CSECT table, sorts the 
symbol table, relocates the LTORG table, outputs ESD 
information. 

IPASS4 Expands the operand field of instructions, outputs TXT, RLD, 


and END information, prints the assembly listing, outputs 
diagnostic file for ADIAG routine. 


© IPAS4A Prints the cross-reference listing (XREF). 
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The assembler can be run as a partially-shared program. It is composed of 29 
two parts: one part can only be run as nonshared, the other part can be run 
as either shared or nonshared. 


The two modules ICOMMON and ISLU are linked into one single object module 
by the Linkage Editor. This object module can be run as nonshared οη]ν. 


All remaining modules are loaded dynamically and are stored in the object 
module library: ASSEMB.LINK.S3020100. 


The module ICONTROL can only be run nonshared. 


The modules IPASS1, IPASS2, IPASS3, IPAS3A, IPASS4, IPAS4A can be run as 
either shared or nonshared. 


When the command /EXEC ASSEMB is issued, the Static Loader loads the object 

module, which issues a LINK call to Dynamic Linking Loader to load the 

ICONTROL module from the OML file. V-type constants defining the entry 

points of the remaining 7 modules (IOPACKGE, IPASS1, IPASS2, IPASS3, 

IPAS3A, IPASS4, IPAS4A) are stored in the IOCONTROL module. When DLL 

loads the IOCONTROL module, the same OML file is searched and the remaining 

7 modules are loaded at the same time as IOCONTROL in order to satisfy all 2 
the V-type constants stored in ICONTROL. 


SHARE commands must be issued by the System Administrator in order to run 
the modules as shared. 

Example 1: 6 modules are to be shared. 

The System Administrator issues the following command: 

/SHARE CIPASS1, IPASS2, IPASS3, IPAS3A, IPASS4, IPAS4A) , 


ASSEMB. LINK.$3020100 


Note 


If there is not enough space to issue the entire SHARE command on the 
same line, several SHARE commands can be issued to achieve the same 
purpose. 


Example 2: Not all 7 modules are shared 


For modules IPASS2 and IPASS4 to be shared, the System Administrator has to 
issue the following command: 


“SHARE CIPASS2, IPASS4) , ASSEMB. LINK. 95020100 
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- 2-4 INPUT TO THE ASSEMBLER 


The assembler assumes that the source program is in a SYSDTA file, and 
reads it using the RDATA macro. When the source correction facility is used, 
the assembler reads the source program from a tape file using BTAM. 

The SYSDTA file may be one of the following: 

1. A card file which is placed in a temporary system file on the disk. 

2. A cataloged SAM file. 

3. A cataloged ISAM file. 

In addition the source program may be entered at a data display terminal, 


or read by the assembler from a program library created in accordance with 
LMS conventions (see section 6.1 COMOPT). 


C Note on 2 and 3: 


It is not permitted to convert SAM files to ISAM files or vice versa 
during assembly. 


1. Sequential Files 


In put records from card reader files and SAM files will be treated as 
80-character card images. The standard columns are 1 for start, 71 for end, 
and 16 for continuation. 

Standard columns may be changed by the assembly ICTL statement. 


BS2000 also accepts input records of up to 128 characters. However, only the 
first 80 bytes are processed, the rest is insignificant. Records shorter 
than 80 bytes will be space-filled (see Appendix A-9). 


2. Indexed Sequential Files 


Indexed sequential files will be treated as variable-length card images. 

Images which are less than 80 characters will be space-filled to the right, 
© and images which are longer than 80 characters will be truncated. Since 

ISAM input files may be in File Editor format, an eight-byte key will be 

assumed to be at the beginning of each record. The assembler aligns the start 

column to character 9, the end column to character 79 and the continue 

column to character 24. 


The eight-byte ISAM key is transferred by the assembler to the card number 
field (columns 73-80). The old card numbers of the input cards are overwritten 
in the process. The card number field in the assembly listing will no longer 
contain the old card numbers, but the corresponding ISAM keys. 

There are, however, a few exceptions? 


- The first statement in the source program is an ICTL statement in which 
a value higher than 71 is specified for the END column. 


— Though the source program is stored as an ISAM file, the assembler reads 
corrections from a correction file. (See also Appendix A-8.) 


- The source program is input via COMOPT SOURCE. 
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2-5 


2-4 


3. Terminal Input 


Input from a terminal will be treated as variable-length card images. Records 
which are not equal to 80 bytes will be space-filled or truncated as in 
indexed sequential input. Columns 1, 71, and 16 will be used as the start, 
end, and continue columns. Column 1 means the first position at which the 
terminal 140 routine releases the keyboard to the user. Horizontal tab 
characters are not recognized by the assembler. 


4. Library Input 


Source programs and COPY members can also be read from program libraries 
generated according to LMS conventions. 


5. Macro Libraries 


A collection of macro definitions may be made available to more than one 
source program by placing the macros in a macro library. The macro 
definition may then be referenced by writing only the macro instruction 
call line. 


Two kinds of macro libraries exist in the system: the system macro library 
(MACROLIB) which is available to all users, and the private macro libraries 
with the link names ALTLIB ог ALTLIBn (2 € n < 5) which are cataloged as 
user files. 


CONTROLLING THE ASSEMBLY SYSTEM 


The assembly system can be controlled by options specified with the aid of 
the xCOMOPT statement (see 6.1). 
Control by the PARAM command is still supported (see 6.2). 
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ç 2.6 OUTPUT FROM THE ASSEMBLER 


1. Program Listings 


The program listings produced аге: a source correction listing, a listing 

of the External Symbol Dictionary (ESD), the source program with the 
corresponding object code and associated flags, the cross-reference listing, 
and diagnostic information. Each listing line is written by means of the 
WRLST Executive macro to a temporary disk file. The listing file is not saved 
after it has been spooled out to the printer. 


2. Object Module File 


The generated object module file is written either to the EAM file or to a 
program library created in accordance with LMS conventions. 


C 3. Diagnostic File 


The diagnostic file contains? the External Symbol Dictionary listing, a source 
program with corresponding object program listing, the cross-reference 
listing, error data, and a summary of errors. The diagnostic file is built 
sequentially as an ISAM file, so that it can be accessed by the Assembly 
Diagnostic Program nonsequentially. 


4. Error File 


The error file is a reduced diagnostic file in which only the invalid 
lines of the listing as well as error information are stored. 


5. ERROR POOL 


If the assembly is terminated when the abortion condition occurs (flag with 

error weight 3 or MNOTE with error code), the assembler outputs a special 

listing. This contains all lines so far determined as invalid together 

with the error descriptions, all MNOTES which have occured and any macro 
C call during generation of which the abortion condition occurred. 


Note 


The scope of the information output to the ERROR POOL depends on the time 
of the abortion. If an abortion occurs in PASS1 due to overflow of a 

VM area, an additional message containing the name of the macro just 
reading is issued: 


xxx FATAL ERROR; PROCESSING MACRO xxxxx 
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2.7 CONSIDERATIONS FOR USE 


2.7.1 Non-File Editor ISAM Source Files 


Since ISAM input files are normally in File Editor format, an eight-byte key 
is assumed to be at the beginning of each record. If a user uses an ISAM 
input file which is not in File Editor format, then an ICTL assembly 
instruction must be used to set the standard columns as required by the 

file format. 


Note, however, that when the assembler detects that SYSDTA is an ISAM file, 
it automatically adjusts column 1 to the ninth byte of the ISAM record. 
Therefore, any data prior to the ninth byte will be lost. 


2.7.2 User Specification of Macro Libraries 


The system macro library is specified with an FCB which has LINK=SYSLIB. 

If a user wishes to supply his own file as the system macro library, he 

may issue a /FILE command with LINK-SYSLIB for the new macro library or he 
may use the default filename, which is MACROLIBs; the corresponding /RELEASE 
command must be issued by the user as well. 


In addition, up to five private user macro libraries may be specified. 
Before the assembly run is started, the corresponding filenames and link 
names (ALTLIB, ALTLIB2, ALTLIB3, ALTLIB4 or ALTLIB5) must be specified in 
the /FILE command. Via *COMOPT control, the assembler is informed of the 
presence of the user macro libraries (in the case of only one private macro 
library this can also be achieved via the /PARAM command ALTLIB=YES). 


Macros may also be contained as TYP=M members of a program library 
generated according to LMS conventions. 
Assignments are likewise specified using ALTLIB. 


If a program library contains several TYP=M members with identical names 


but different version numbers, the member having the highest version number 
is used. 
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C 2.7.3 Priority Relationship in Macro Libraries 


Both the system macro library and up to five user macro libraries can be 
referenced in the same assembly. In the event of a macro the macro 
definitions are sought in accordance with the following rules: 


— Each macro definition is read once only. 


— The sequence of the macros in the source program is immaterial for the 
read algorithm. 


— For each macro that is not an inner macro the macro definitions are 
sought and read in accordance with the following search hierarchy: 


Source program 
ALTLIB 

ΑΙ ΤΙ 182 

ΑΙ ΤΙ 1832 
ALTLIB4 


© ΑΙ ΤΙ 1Β5 


Subsequentlv, all first level inner macros are sought and, if this 
has not vet be done, read in; then all second level inner macros, etc. 


If the last macro level is closed and there are still anv undefined macros, 
then a search for them is made in the system macro library (SYSLIB). 

Inner macros of macros from the SYSLIB are only sought in the SYSLIB if the 
corresponding macro definitions have not been read in previously. 


For example, if a system macro, M1, calls on macros PR1 and PR2, then the 


user may include ΡΒ] and PR2 in his own library and they may be referenced 
by the source program without being generated in the following manner: 


. SKIP 


.SKIP 


Macros PR1 and PR2 will then be taken from the user's private library. 
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2.7.6 


2.7.5 


2.7.6 


Obtaining an Object Module on Cards 


The BS2000 assembler will not punch object cards. A user must issue a 
/PUNCH command for the Object Module File which is created by an assembly. 


Obtaining an Assembly Listing from the Diagnostic File 


When SAVLST=ALL is specified, production of the normal listing (with 
ASMLST=YES) is redundant. The listing can be produced from the diagnostic 
file by using the PRINT or END L ADIAG statements. 


Diagnostic File and Error File Naming 


The assembler forms the name of the diagnostic file by suffixing the 
characters SAVLST.ASSEMB. with the name of the program's first CSECT. 

Thus if the first CSECT (or the START statement) of a program is named ZZZ, 
the diagnostic file for that program has the name SAVLST.ASSEMB.ZZZ. If the 
first CSECT is unnamed, the file name will be SAVLST.ASSEMB.<TSN-number>. 

This means that two programs having the same CSECT name will also have the 
same diagnostic file name. 

It may be necessary to change the name of the first program's diagnostic file 
to prevent it being overwritten. See the Data Management System Manual for the 
methods available to change an existing file name. 


If the diagnostic file is to be given a different name, an additional FILE 
command with the LINK=SAVLINK option (e.g. /FILE DIAG,LINK=SAVLINK) has to 
be input before the assembler is invoked. During assembly, the diagnostic 
file will then get the file name that is specified in the FILE command 
i.e. DIAG in the present example) and the file link name SAVLINK. 


Similarly, the name of the error file will get the format 


ERRFIL.ASSEMB.«1st SECT name». The name can be chosen at random with the 
aid of the LINK-ERRLINK option. 
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© 2.7.7 Saving ог Executing an Assembled Program 


The object modules generated are either stored in a program library created 
in accordance with LMS conventions (see COMOPT MODULE) or in the EAM file. 


The object modules contained in the temporary EAM file can be further 
processed as described below. On completion of the task the EAM file 
is deleted. | 

e Saving the object modules from EAM 


— іп a program library with the aid of the LMS; 
— by means of an output on punched cards (/PUNCH.X). 


ϱ Linking the object modules from EAM 
The TSOSLNK Linkage Editor links 
— either one or more object modules to form a load program, which 
it stores in a cataloged file, 
C — or several object modules to form one object module, which it stores 
in the EAM file. 
e Execution with the DLL 
The DLL is started by means of the /EXEC_* command. The object modules 


are linked; the load program is loaded and started. The program is not 
saved. 
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© : ASSEMBLY LANGUAGE DESCRIPTION 


3.1 ASSEMBLY LANGUAGE CODING CONVENTIONS 


3.1.1 Statements 


A source program is a sequence of source statements that are punched into 
cards. These statements may be written on the standard coding form, 
(Figure 3-1). One line of coding on the form is punched into one card. The 
vertical columns on the form correspond to card columns. 


Space is provided on the form for program identification. This information 
© is not punched into а card. 


The body of the form (Figure 3-1) is composed of tuo fields: 

the statement field, columns 1-71, and the identification sequence field, 
columns 73-80. The identification sequence field is not part of a statement 
and is discussed following the subsection Comments Statements (3.1.1.4). 


The entries (i.e., coding) composing a statement occupy columns 1-71 of a 
statement line and, of needed, columns 16-71 of successive continuation 
lines. 


3.1.1.1 Continuation Lines 


When it is necessary to continue a statement on another line, the following 
rules apply: 


C 1. Continuation may be specified by entering any nonblank character in column 
72 of the statement line; if nothing is placed in column 72, the source 
statement is considered complete. 


2. Continue the statement on the next line, starting in the continue 
column (16). Columns to the left of the continue column must be blank. 


3. On comment cards, column 72 is ignored; there are no continuation cards 
for comments. 


Two continuation lines are allowed for the operand field of an assembly or 
machine instruction. This does not apply to macro instructions and prototype 
statements in macro definitions (see section 4.7.4, Alternate Statement 
Form). 


The comment field of any statement may be continued on one additional line. 
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3.1.1.2 Statement Boundaries 


Source statements are normally contained in columns 1-71 of any statement 
lines and columns 16-71 of any continuation lines. Therefore, columns 1, 
71, and 16 are referred to as the "begin", "end", and "continue" columns, 
respectively. This convention may be altered by use of the Input Format 
Control (ICTL) assembly instruction discussed later in this publication. 


However, macro definitions must be written in standard form. 
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3.1.1.3 Statement Format 


There are two types of statement: instructions and comments. 


Instructions mav consist of one to four entries; a name entry, an operation 
entry, an operand entry, and a comments entry. These entries must be 
separated by one or more blanks, and must be written in the order stated 
above. Total statement size is limited only by the continuation line 
restriction and the rules governing the syntax of individual items used in 
the operand field. 


The coding form (Figure 3-1) is ruled to provide an eight-character name 
field, a five-character operation field, and a 56-character operand and/or 
comments field. 


If desired, the programmer may disregard these boundaries and write the name, 
operation, operand, and comment entries in other positions, subject to the 
following rules: 


1. The entries must not extend beyond statement boundaries (either the 
conventional boundaries, or those fixed by the programmer via the ICTL 
instruction). 


2. The entries must be in proper sequence, as stated above. 
j. The entries must be separated by one or more blanks. 
4. If used, a name entry must be written starting in the begin column. 


5. The name and operation entries must be completed on the first line of 
the statement, including at least one blank following the operation 
entry. 


A description of the name, operation, operand, and comments entries follows: 


& 


Name Entries: The name entry is a symbol, composed of eight characters, 

or less, created by the programmer to identify a statement. A name entry is 
usually optional, but, if present, must be entered with the first (or only) 
character appearing in the begin column. If the begin column is blank, the 
assembler assumes no name has been entered. Blanks must not appear within 
a name entry, whether the symbol was introduced directly by the programmer 
or indirectly by conditional assembly or macro generation. 


3-6 Assembler V29.1C, U62-J-Z55-6-7600 


Coding conventions 


Operation Entries: The operation entry is the mnemonic operation code 
specifying the desired machine operation, macro, or assembler function. 

An operation entry is mandatory and must appear in the first statement line, 
starting at least one position to the right of the begin column. Valid 
mnemonic operation codes for machine and assembler operations are contained 
in Appendices A-6 and Α-Ζ of this publication. Valid operation codes consist 
of five characters or less for machine or assembler operation codes, and 
eight characters or less for macro-instruction operation codes. 

No blanks may appear within the operation entry. 


The mnemonic operation code can be changed by means of the OPSYN statement 
(see 3.32.10). 


Operand Entries: The operand entries contain the codes which describe or 
address the storage locations, masks, storage-area length or types of data to 
be processed. 


Depending on the needs of the instruction, one or more operands may be 
written. Operands are required for all machine instructions. 


Operands must be separated by commas. Blanks must not intervene between 
operands and the commas that separate them. 


The operands may not contain embedded blanks except as follows: 

If character representation is used to specify a constant, a literal, or 
immediate data in an operand, the character string may contain blanks, 
e.g. C'AP.D'. 


Comments Entries: Comments are descriptive items of information about the 
program that are to be inserted in the program listing. All 256 valid 
characters, including blanks, may be used in writing a comment. The entry 
cannot extend beyond the end column (normally column 71), and a blank must 
separate it from the operand. 


In instructions where an operand entry is not present but a comments entry 


is desired, the absence of the operand entry must be indicated by a comma 
preceded and followed by one or more blanks, as follows: 


, COMMENT 


, COMMENT 


Assembler V29.1C, U62-J-255-6-7600 3-5 


Coding conventions 


Instruction Example: 


The following example illustrates the use of name, operation, operand, and 
comments entries. A compare instruction has been named by the symbol COMP, 
the operation entry (CR) is the mnemonic operation code for a register-to- 
register compare operation, and the two operands (5,6) designate the two 
general registers whose contents are to be compared. 


The comments entry reminds the programmer that with this instruction he is 
comparing "new" sum with "old". 


COMPL CR 5,6 NEM SUM TO OLD 


Summary of Instruction Format: 


€ The entries in an instruction must always be separated by at least one 
blank and must be in the following order? name, operation, operand(s), 
comment. 


€ Every statement requires an operation entry. Name and comment entries are 
optional. Operand entries are required for all machine instructions 
and most assembly instructions. 


€ The name and operation entries must be completed in the first statement 
line, including at least one blank following the operation entry. 


€ The name and operation entries must not contain blanks. Operand entries 
must not have blanks preceding or following the commas that separate 
them. 

€ A name entry must always start in the "begin" column. 

e If the column after the end column is blank, the next line must start 
a new statement. If the column after the end column is not blank, the 


following line will be treated as a continuation line. 


Φ All entries must be contained within the designated begin, end, and 
continue column boundaries. 
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S 3.1.1.4 Comments Statements 


Comments statements are used to include a programmer's notes on in assembly 
listing. (These notes can be helpful during debugging and maintenance of a 
program). Comments statements have no effect on the assembled program; they 
are only printed in the assembly listing and, therefore, may appear at any 
point. Extensive notes, or comments, may be written by using a series of 
comments statements. 


There are tuo types of comments statements. One type, written with an 
asterisk (x) in the begin column, is used for comments on the source program. 
The other type, written with a period in the begin column and followed by 

an asterisk, is used for comments on a macro definition. This type is further 
described in chapter 4 entitled "Hou to Prepare Macro Definitions". 


An example of the comments statement is: 


C x THIS COMMENT IS CONTINUED X (is ignored) 
x ON ANOTHER LINE. 


3.1.1.5 Identification-Sequence Field 


The identification-sequence field of the coding form (columns 75-60) is 

used to enter program identification and/or statement sequence characters. 
The entry is optional. If the field, or a portion of it, is used for program 
identification, the identification is punched in the statement cards, and 
reproduced in the printed listing of the source program. 


As an aid to keeping source statements in order, the programmer may code 

an ascending sequence of characters in this field or a portion of it. 

These characters are punched into their respective cards, and, during 

assembly, the programmer may request the assembler to verify this sequence 

by use of the Input Sequence Checking (ISEQ) assembly instruction. This 
C instruction is discussed in section 3.33.2. 


3.1.1.6 Character Set 


Source statements are written using the following characters: 

Letters: A through Z, and $, # and а 

Digits: 0 through 9 

Special characters: +- , = . х ( ) ' / ἃ blank 

These characters are represented by the card punch combination and internal 
bit configuration listed in Appendix A-3. In addition, any of the 256 punch 
combinations may be designated by characters that appear between paired 


apostrophes (hexadecimal representation in comments, and in macro 
Ç instruction operands). 
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5.2 


ASSEMBLY LANGUAGE STRUCTURE 


The basic structure of the language can be stated as follous. 
A source statement is composed of: 

9 A name entry (usually optional). 

€ An operation entry (mandatory). 

€ An operand entry (usually required). 


€ A comments entry (optional). 


Notes 
— A name entry is a symbol. 


— An operation entry is a mnemonic operation code representing a machine, 
assembly or macro instruction. 


— Ап operand entry is one or more operands composed of one or more 
expressions, which, in turn, are composed of a term or an arithmetic 
combination of terms. 


— JQÜperands of machine instructions generally represent such things as 
storage locations, general registers, immediate data, or constant values. 
Operands of assembly instructions provide the information needed by the 
assembler program to perform the designated operation. 


Terms shown in Figure 3-2 are classed as absolute or relocatable. Terms are 
absolute or relocatable depending on the effect of the program relocation 
upon them. (Program relocation is the loading of the object program into 
storage locations other than those originally assigned by the assembler 
program.) A term is absolute if its value does not change upon relocation. 
A term is relocatable if its value changes upon relocation. 


The following subsection, Terms and Expressions, discusses these items as 
outlined in Fig. 3-2. 
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Ө 3.3 TERMS AND EXPRESSIONS 


3.3.1 Terms 


Every terms represents a value. This value may be assigned by the assembler 
program (symbols, symbol length attributes, location counter reference) or may 
be inherent in the term itself (self-defining term, literal). 


An expression, an arithmetic combination of terms, is reduced to a single 
value by the assembly program. 


Each type of term and the rules for its use will now be discussed. 


C 3.3.2 Symbols 


A symbol is a character or combination of characters used to represent 
locations or arbitrary values. Symbols, through their use in name fields and 
in operands, provide the programmer with an efficient means of naming and 
referencing a program element. There are three types of symbols: 


1. Ordinary symbols. 


2. Variable symbols. 
3. Sequence symbols. 
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Fig. 3-2 Terms and Expressions 
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© Ordinary symbols consist of one to eight letters and/or numbers, the 
first of which must be a letter. Such symbols are used to identify 
machine locations or arbitrary values. In the following sections, where 
symbols occur, they refer to this type of term. 


Absolute symbols are ordinary symbols whose values do not change upon 
program relocation. 


Relocatable symbols are ordinary symbols whose values change upon 
relocation. 


The following are valid ordinary symbols: 


READER 
Α23456 
X4F2 
LOOP2 
N 
54 

© aB4 
$A1 
#56 


The following ordinary symbols are invalid, for the reasons noted: 


256B First character is not alphabetic. 
RECORDAREA2 More than eight characters. 

BCDx34 Contains a special character - an asterisk. 
IN AREA Contains a blank. 


Variable symbols must begin with an ampersand (&) followed by one to 

seven letters and/or numbers, the first of which must be a letter. Variable 
symbols allow different values to be assigned to one symbol. The characters 
that replace a variable symbol must conform to the syntax rules governing 
the field in which the variable symbol occurs. (A complete discussion of 
variable symbols appears in a later section.) 


Sequence symbols consist of a period (.) followed by one to seven letters 

© and/or numbers, the first of which must be a letter. Sequence symbols аге 
used to indicate the position of statements within the source program or 
macro definition. Through their use the programmer can vary the sequence in 
which statements are processed by the assembler program. Variable symbols 
cannot bs used to generate a sequence symbol in the name entry of a 
statement. (See the complete discussion in a later section.) 
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3.4 


DEFINING SYMBOLS 


The assembler assigns a value to each symbol appearing as a name entry in a 
source statement. The values assigned to symbols naming storage areas, 
instructions, constant, and control sections are the addresses of the 
leftmost bytes of the storage fields containing the named items. Since the 
addresses of these items may change upon program relocation, the symbols 
naming them are considered relocatable terms. 


A symbol used as a name entry in the Equate Symbol (EQU) assembly 

instruction is assigned a value designated in the operand entry of the 
instruction. Since the operand entry may represent a relocatable value, or an 
absolute (i.e., nonchanging) value, the symbol is considered a relocatable 
term or an absolute term, depending on the value to which it is equated. 


The value of a symbol may not be negative and may not exceed 224-3, 


А symbol is said to be defined when it appears as the name of a statement 
which appears in the source after all conditional assembly statements have 
been evaluated. (A special case of symbol definition is discussed in section 
3.16, "Program Sectioning and Linking"). 


Symbol definition also involves the assignment of a length attribute to the 
symbol. (The assembler maintains an internal table - the symbol table - 

in which the values and attributes of symbols are kept. When the assembler 
encounters a symbol in an operand, it refers to the table for the values 
associated with the symbol). The length attribute of a symbol is the length, 
in bytes, of the storage field whose address is represented by the symbol. For 
example, a symbol naming an instruction that occupies four bytes of storage 
has a length attribute of 4. Note that there are exceptions to this rule: 
for example, in the case where symbol has been defined by an equate to 
location counter value (EQUX) or by a self-defining term, the length 
attribute of the symbols is 1. These and other exceptions are noted under 
the instructions involved. The length attribute is never affected by a 
duplication factor. 


3.4.1 Previously Defined Symbols 


The assembly language requires that symbols appearing in the operand entry of 
some instructions be previously defined. This simply means that the symbols, 
before their use in an operand, must have appeared as the name entry of a 
prior statement. 


For example: 


ЅҮМ1 MVC A,B 
SYM2 EQU SYM1 


would be a valid sequence of coding. The symbolic address of SYM1 must be 
defined before the EQU statement. 
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C 3.4.2 General Restrictions on Symbols 


A symbol may be defined only once in an assembly. While the same symbol may 
appear as the name of two or more statements before macro generation and 
conditional assembly, only one such statement should be generated. In 
addition, a symbol may be used in the name field more than once as a 
control section name (i.e., defined in the START, CSECT, COM, or DSECT 
assembly statements) because the coding of a control section may be 
suspended and then resumed at any subsequent point. The CSECT or DSECT 
statement that resumes the section must be named by the same symbol that 
initially named the section; thus, the symbol that names the section must be 
repeated. Such usage is not considered to be duplication of a symbol 
definition. 


3.5  SELF-DEFINING TERMS 


A self-defining term is one whose value is inherent in the term. It is not 
assigned a value by the assembler program. For example, the decimal sel f- 
defining term >> 15 << represents a value of fifteen. 


There are four types of self-defining terms: decimal, hexadecimal, binary, 
and character. Use of these terms is spoken of as decimal, hexadecimal, 
binary, or character representation of the machine language binary value or 
bit configuration they represent. 


Self-defining terms are classed as absolute terms because the values they 
represent do not change upon program relocation. 


3.5.1 Using Self-Defining Terms 


Self-defining terms are the means of specifying machine values or bit 
configurations without equating the values to symbols and using the symbols. 
© Self-defining terms тау be used to specifv such program elements as 
immediate data, masks, registers, addresses, and address increments. 


The use of a self-defining term is quite distinct from the use of data 
constants or literals. When a self-defining terms is used in a machine- 
instruction statement, its value is assembled into the instruction. When 

a data constant or literal is specified in the operand of an instruction, its 
address is assembled into the instruction. 


Note that variable symbols may be used to generate self-defining terms in 
assembly and machine instructions. 
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3.5.2 Decimal Self-Defining Term 


3.5.3 


A decimal self-defining term is simply an unsigned decimal number written as 
a sequence of decimal digits. High-order zeros may be used (e.g., 007). 
Limitations on the value of the term depend on its use. For example, a 
decimal term that designates a general register must have a value between 0 
and 15 inclusive; one that represents an address must not exceed the size of 
storage. In any case, a decimal term may not consist of more than eight 
digits or exceed 16,777,215 (22*-1). A decimal term is assembled as its 
binary equivalent. Some examples of decimal self-defining terms are 8147, 
8147; 4092; 00021. 


Hexadecimal Self-Defining Term 


A hexadecimal self-defining term is an unsigned hexadecimal number written 
as a sequence of hexadecimal digits. The digits must be enclosed in single 
apostrophes and preceded by the letter X: X'C49'. 


Each hexadecimal digit is assembled as its four-bit binary equivalent. Thus, 
a hexadecimal term used to represent an eight-bit mask would consist of two 
hexadecimal digits. The maximum value of a hexadecimal term is X'FFFFFFFF'. 


The hexadecimal digits and their bit patterns are as follows: 


0 0000 4 0100 8 1000 C 1100 
1 0001 5 0101 9 1001 D 1101 
2 0010 6 0110 ^ 1010 Е 1110 
3 0011 7 0111 B 1011 F 1111 


A table for converting from hexadecimal representation to decimal 
representation is provided in Appendix Α-ά. 
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© $.5.4 Binary Self-Defining Term 


A binary self-defining term is written as an unsigned sequence of l's 

and 0's enclosed in apostrophes and preceded by the letter B, as follows? 
B'10001101'. This term would appear in storage as shown, occupying one byte. 
A binary term may have up to 32 bits represented. Padding with binary zero 
is on the left. 


Binary representation is used primarily in designating bit patterns of masks 
or in logical operations. 


The following example illustrates a binary term used as a mask in a Test 
Under Mask (TM) instruction. The contents of GAMMA are to be tested, bit by 
bit, against the pattern of bits represented by the binary term. 


Name Operation Operand 


ALPHA TM GAMMA ,B* 10101101* 


3.5.5 Character Self-Defining Term 


A character self-defining term consists of one to four characters enclosed 

by apostrophes. It must be preceded by the letter C. All letters, decimal 
digits, and special characters may be used in a character term. In addition, 
any of the remainder of the 256 punch combinations may be designated in a 
character self-defining term. Examples of character self-defining terms are as 
follows’ 


Саут С" (tuo blanks) 
C'ABC' C*13* 


Because of the use of apostrophes in the assembly language and ampersands 

in the macro language as syntactic characters, the following rule must be 

observed when using these characters in a character term. For each apostrophe 

or ampersand desired in a character term, two apostrophes or ampersands must 
Є be written. For example, the character value A'# would be written CTA“ !, 

while an apostrophe followed by a blank and another apostrophe would be 

written as Ον ***, 


Each character in the character sequence is assembled as its eight-bit 
(EBCDIC) code equivalent (see Appendix A-3). The two apostrophes or 
ampersands that must be used to represent a single apostrophe or ampersand 
within the character sequence are assembled as a single apostrophe or 
ampersand. 
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3-6 LOCATION COUNTER REFERENCE 


A Location Counter is used to assign addresses to program statements. It is 
the assembler program's equivalent of the instruction counter in the 
computer. As each machine instruction or data area is assembled, the 

Location Counter is first adjusted to the proper boundary for the item, if 
adjustment is necessary, and then incremented by the length of the 

assembled item. Thus, it always points to the next available location. If the 
statement is named by a symbol, the value assigned to the symbol is the 

value of the Location Counter after boundary adjustment, but before addition 
of the length. 


The assembler maintains a Location Counter for each control section of the 
program and uses each Location Counter as previously described. 


Source statements for each section are assigned addresses from the Location 
Counter for that section. The Location Counter for each successively 
declared control section assigns locations in consecutively higher areas of 
storage. If a program has multiple control sections, all statements 
identified as belonging to the first control section will be assigned from 
the Location Counter for section 1, the statements for the second control 
section will be assigned from the Location Counter for section 2, etc. 

This procedure is followed whether the statements from different control 
sections are interspersed or written in control section sequence. 


The Location Counter setting can be controlled by using the START and ORG 
assembly instructions. The counter affected by either of these assembler 

instructions is the counter for the control section in which they appear. 
The maximum value for the Location Counter is 2?^-]. 


The programmer may refer to the current value of the Location Counter at 

any place in a program, by using an asterisk in an operand. The asterisk 
represents the location of the first byte of storage currently available 
(i.e., after any required boundary adjustment). Using an asterisk in a 
machine instruction statement is the same as placing a symbol in the name 
field of the statement and then using that symbol as an operand of the 
statement. Because a Location Counter is maintained for each control section, 
a Location Counter reference designates the Location Counter for the 

section in which the reference appears. 


A reference to the Location Counter may be made in a literal address 
constant (i.e., the asterisk may be used in an address constant specified in 
literal form). The address of the instruction containing the literal is used 
for the value of the Location Counter. A Location Counter reference may not 
be used in a statement which requires the use of a predefined symbol, with 
the exception of the EQU and ORG assembly instructions. 
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LITERALS 


A literal term is one of three basic ways to introduce data into a program. 
It is simply a constant preceded by an equal sign (=). 


A literal represents data rather than a reference to the location of the 
respective data. The appearance of a literal in a source statement directs 
the assembler program to assemble the data specified by the literal, store 
this data in the "literal pool" of memory, and replace the literal in the 
statement by the address of the memory location containing the data. 


Literals provide a means of entering constants (such as numbers for 
calculation, addresses, indexing factors, or words or phrases for printing 
out a message) into a program by specifying the constant in the operand of 
the instruction in which it is used. This is in contrast to using the DC 
assembly instruction to enter the data into the program, and then using the 
name of the DC instruction in the operand. Only one reference to a literal is 
allowed in a machine instruction statement. 


A literal term may not be combined with any other terms. 


A Literal may not be used as the receiving field of an instruction that 
modi fies storage. 


A literal may not be specified in an address constant (DC - Define Constant). 
An S-type address constant may not be used as a literal. 


The instruction coded below shows one use of a literal. 


GAMMA L 10,=F* 274° 


The statement GAMMA loads a register using a literal as the second operand. 
When assembled, the second operand of the instruction will be the address 
at which the binary value represented by F'274' is stored. 


Further examples are included in the description of the DC instruction. 


In general, literals may be used wherever a storage address is permitted as 
an operand. They may not, however, be used in any assembly instruction. 
Literals are considered relocatable, because the address of the literal, 
rather than the literal itself, will be assembled in the statement that 
employs a literal. 


The assembler generates the literals, collects them, and places them in a 
specific area of storage, as explained in section 3.7.1, "The Literal Pool". 
A literal is not be confused with the immediate data in an SI instruction. 
Immediate date is assembled into the instruction. 
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3.7.1 Literal Format 


The assembler requires as description of the type of literal being specified 
as well as the literal itself. This descriptive information assists the 
assembler in assembling the literal correctly. The descriptive portion of the 
literal must indicate the format in which the constant is to be assembled. 

It may also specify the length the constant is to occupy. 


The method of describing and specifying a constant as a literal is nearly 
identical to the method of specifying it in the operand of a DC assembly 
instruction. The difference is that the literal must start with an equal 
sign (=), which indicates to the assembler that a literal follows. The type 
of literal designated in an instruction is not checked for correspondence 
with the operation code of the instruction. 


Some examples of literals are: 


=A( BETA) address constant literal. 
=F" 1234" a fixed-point number with a length of four bytes. 
-C'ABC' a character literal. 


The Literal Pool: The literals processed by the assembler are collected 
and placed in a special area called the literal pool, and the location of 
the literal itself is assembled in the statement employing a literal. The 
positioning of the literal pool may be controlled by the programmer with 
the aid of the LTORG statement. Unless otherwise specified, the literal 
pool is placed at the end of the first control section. 


The programmer may also specify that multiple literal pools be created. 


However, the sequence in which literals are ordered within the pool is 
controlled by the assembler, not by the programmer. 
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SYMBOL LENGTH ATTRIBUTE REFERENCE 


The length attribute of a symbol may be used as a term by coding L' followed 
by the symbol, as in: L'BETA. 


The length attribute of BETA will be substituted for the term. The following 
example illustrates the use of L' symbol in moving a character constant into 


either the high-order or low-order end of a storage field. 


To clarify the example, the length attributes of Al and B2 are given. 


A1 DS CL8 

B2 DC CL2* AB’ 

HIORD MVC A1CL'B2),B2 

LOORD MVC Al*L'Al1-L'B2(L'B2),B2 


Al names a storage field eight bytes in length and is assigned a length 
attribute of eight. 


B2 names a character constant two bytes in length and is assigned a length 
attribute of two. 


The statement named HIORD moves the contents of B2 into the leftmost two 
bytes of Al. The term L'B2 in parentheses provides the length specification 
required by the instruction. When the instruction is assembled, the length 
is placed in the proper field of the machine instruction. 


The statement named LOORD moves the contents of B2 into the rightmost two 
bytes of Al. The combination of terms Al-L'A1-L'B2 results in the addition of 
the length of Al to the beginning address of A1, and the substraction of the 
length of B2 from this value. The result is the address of the seventh 

byte in field Al. The constant represented by B2 is moved into Al starting at 
this address. L'B2 in parentheses provides length specification as in HIORD. 


Note: 
The length attribute of * is equal to the length of the instruction in 


which it appears, except in an EQU * statement without length operand 
(see 3.26), where the length attribute is 1. 
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3-9 EXPRESSIONS 


Expressions, which are used in coding operand entries for assembly language 
statements, are composed of either a single term or an arithmetic combination 
of terms (see Figure 3-2). Arithmetically combined terms, enclosed in 
parentheses, may be used in combination with terms outside the parentheses. 


For example: 
14+BETA-(GAMMA-LAMBDA) 


khen terms in parentheses occur in combination with other terms, like 
(GAMMA-LAMBDA) in the example, the parenthesized terms are reduced first to 
a single value. This value may be absolute or relocatable, depending on the 
combination of terms. This value is then used in reducing the rest of the 
combination to another single value. 


Parenthesized terms may be included within another set of terms in 
parentheses. 


For example: 
A+B-(C+D-(E+F)+10) 


This expression has two levels of parentheses. A level of parentheses is a 
left parenthesis and its matching right parenthesis. One level of paren- 
theses surrounds E*F. The next higher level of parentheses surrounds 
C+D-(E+F)+10. The innermost set of terms in parentheses (the lowest level) 
is evaluated first. 


The following are examples of valid expression: 


x TEN/TWO 

AREA 1*X' 2D* ΒΕΤΑΧ10 

x32 B 101' 

N-25 C'ABC' 
FIELD+332 29 

FIELD L'FIELD 
(EXIT-ENTRY- 1) +60 LAMBDA-4* GAMMA 
=F" 1234" 


ΑΙ ΡΗΑ-ΒΕΤΑ/{( 10+AREA*L"FIELD) -100 
A*(A*(A*(A+1)+3*(B-3))) 


The rules for coding expressions are: 


1. An expression may not start with an arithmetic operator other than '-'. 
Thus, -А+ВЕТА is valid but +A+5 is not. 


2. An expression may not contain two terms or two operators in succession. 


3. An expression may not contain more than 6 levels of parentheses or 6 
uncombined subexpressions at any time. 


4. A multi-term expression may not contain a literal. 
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3.9.2 


Expressions 
Evaluation of Expressions 


A single term expression, e.g., 29,BETA,*, or L'SYMBOL, takes on the value 
of the term involved. 


A multi-term expression, e.g., BETA*10, ENTRY-EXIT, 25%10+AYB,) is reduced 
to a single value, as follous: 


1. Each term is given its value. 


2. Arithmetic operations are performed left to right. Multiplication and 
division are done before addition and subtraction, e.g., A*BxC is 
evaluated as A*t(BxC), not (А+В) єС. The computed result is the value of the 
expression. 


3. Every expression is computed to 32 bits. 


4. Divisions always yields an integer result; any fractional portion of the 
result is dropped. E.G., 1/2%10 yields a zero result, whereas 10x1/2 
yields 5. 


5. Division by zero is valid and yields a zero result. 


Parenthesized expressions used in an expression are processed before the rest 
of the terms in the expression, e.g., in the expression A+BETA*(CON+10), the 
term CON*10 is evaluated first and the resulting value used in computing the 
final value of the expression. | 


Final values of expressions must be between -2?^ and 2?^-1 (inclusive). 
Intermediate results may have a value between -23!and 2°' -1 (inclusive). 


Absolute and Relocatable Expressions 


An expression is called absolute if its value is unaffected bv program 
relocation. 


An expression is called relocatable if its value changes upon program 
relocation. 


The two types of expressions, absolute and relocatable, take on these 
characteristics from the term or terms composing them. This relationship 
will now be discussed. 
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Absolute Expressions: An absolute expression may be an absolute term or 
any arithmetic combination of absolute terms. An absolute term may be an 
absolute symbol, any of the self-defining terms, or the length attribute 
reference. As indicated in Figure 3-2, all arithmetic operations are 
permitted between absolute terms. 


An absolute expression may contain relocatable terms (RT) - alone or in 
combination with absolute terms (AT) - under the following conditions: 


1. There must be an even number of relocatable terms in the expression. 


2. The relocatable terms must be paired. Each pair of terms must have the 
same relocatability attribute, i.e., they appear in the same control 
section in this assembly. Each pair must consist of terms with opposite 
signs. The paired terms do not have to be contiguous, e.g., RT+AT-RT. 


3. No relocatable expression may enter into a multiply or divide operation. 
(RT-RT)*10 is, however, valid. 


The pairing of relocatable terms (with opposite signs and the same 
relocatability attribute) cancels the effect of relocation. Therefore, the 
value represented by the paired terms remains constant, regardless of program 
relocation. For example, in the absolute expression A*X-Y, A is an absolute 
term, and X and Y are relocatable terms with the same relocatability 
attribute. If A equals 50, Y equals 25, and X equals 10, the value of the 
expression would be 35. If X and Y are relocated by a factor of 100 their 
values would then be 125 and 110. However, the expression would still 
evaluate as 35 (50-125+110)=35). 


An absolute expression reduces to a single absolute value. 


The following examples illustrate absolute expressions. A is an absolute 
term; Y and X are relocatable terms with the same relocatability attribute. 


A-Y+X 
A 

ΑΧΑ 
X-Y+A 
x-Y 


Note 


A reference to the Location Counter must be paired with another 
relocatable term from the same control section, i.e., with the same 
relocatability attribute. 
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© Relocatable Expressions: A relocatable expression is one whose value would 
change by n if the program in which it appears is relocated n bytes away from 
its originally assigned area of storage. 


A relocatable expression may be a relocatable term. A relocatable expression 
may contain relocatable terms - alone or in combination with absolute 
terms - under the following conditions: 


1. There must be an odd number of relocatable terms. 


2. All the relocatable terms but one must be paired. Pairing is described 
under "Absolute Expressions". 


3. No relocatable term may enter into a multiply or divide operation. 


A relocatable expression reduces to a single relocatable value. This value 
is the value of the odd relocatable term, adjusted by the values represented 
by the absolute terms and/or paired relocatable terms associated with it. 


For example, in the expression W-X+W-10W, and X are relocatable terms with 
the same relocatability attribute. If initially N equals 10 and X equals 5, 
S the value of the expression is 5. However, upon relocation this value will 
the value of the expression is 5. However, upon relocation this value will 
change. If a relocation factor of 100 is applied, the value of the expression 
is 105. Note that the value of the paired terms, W-X, remains constant at 5 
regardless of relocation. Thus, the new value of the expression, 105, is the 
result of the value of the odd term (HW) adjusted by the values of W-X and 10. 


The following examples illustrate relocatable expressions. A is an absolute 
term, W and X are relocatable terms with the same relocatability attribute, 
Y is a relocatable term with a different relocatability attribute. 


Y-32xA =F" 1234" (literal) 
W-X+Y AXA+W-W+Y 
* (reference to W-X+W 
Location Counter) Y 
W-X+ 
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3-10 ADDRESSING - PROGRAM SECTIONING AND LINKING 


3.11 


3-26 


The 4004 and 7.000 addressing technique requires the use of a base register, 
which contains the base address, and a displacement, which is added to the 
contents of the base register. The programmer may specify a symbolic address 
and request the assembler to determine its storage address in terms of a base 
register and a displacement. The programmer may rely on the assembler to 
perform this service for him by indicating which general registers are 
available for assignment and what values the assembler may assume each 
contains. The programmer may use as many or as few registers for this 
purpose as he desires. The only requirements are that, at the point of 
reference, a register containing an address from the same control section is 
available, and that this address is less than or equal to the address of the 
item to which the reference is being made. The difference between the two 
addresses may not exceed 4095 bytes. 


ADDRESSES - EXPLICIT AND IMPLIED 


An address is composed of a displacement plus the contents of a base register. 
In the case of RX instructions, the contents of an index register are also 
used to derive the address. Care must be taken not to index across segment 
boundaries. 


The programmer writes an explicit address by specifying the displacement and 
the base register number. In designating explicit addresses a base register 
may not be combined with a relocatable symbol. 

He writes an implied address by specifying an absolute or relocatable 
address. The assembler has the facility to select a base register and compute 
a displacement, thereby generating an explicit address from an implied 
address provided that it has been informed 

€ what base registers are available to it and 


€ what each contains. 


The programmer conveys this information to the assembler through the USING 
and DROP assembly instructions. 
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@ 3.12 BASE REGISTER INSTRUCTIONS 


The USING and DROP assembly instructions enable programmers to use 
expressions representing implied addresses as operands of machine instruction 
statements, leaving the assignment of base registers and the calculation of 
displacement to the assembler. In order to use symbols in the operand field 
of machine instruction statements, the programmer must 


e indicate to the assembler, by means of a USING statement, that one or 
more general registers are available for use as base registers, 


€ specify, by means of the USING statement, what value each base register 
contains, and 


€ load each base register with the value he has specified for it. 


A program must have at least one USING statement for each control section 
that is implicitly addressed. 


© Having the assembler determine base registers and displacements relieves 
the programmer of separating each address into a displacement value and a 
base address value. This feature of the assembler will eliminate a likely 
source of programming errors, thus reducing the time required to check out 
programs. To take advantage of this feature, the programmer uses the USING 
and DROP instructions described in this subsection. The principal discussion 
of this feature follows the description of both instructions. 


3.12.1 USING - Use Base Address Register 


The USING instruction indicates that one or more general registers are 
available for use as base registers. This instruction also states the base 
address values that the assembler may assume will be in the registers at 
object time. Note that a USING.instruction does not load the registers 
specified. It is the programmer's responsibility to see that the specified 
base address values are placed into the registers. Suggested loading methods 
C are described in section 3.12.2., "Programming with the USING instruction". 


The typical form of the USING instruction statement is: 


Not From 2-17 expressions of 
used the form v,r1,r2,r3,...,r16 


Operand v must be an absolute or relocatable expression with a value 

ranging from -27247 to +2T24T-1. No literals are permitted. Operand v specifies 
a value that the assembler can use as a base address. The other operands 

must be absolute expressions. The operand rl specifies the general register 
that can be assumed to contain the base address represented by operand 

v. Operands r2, r3, r4,... specify registers that can be assumed to contain 
v+6096, v+8192, v*12288,..., respectively. The values of the operands 

rl, rz, r3,...,rl6 must be between 0 and 15. For example the statement: 
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Name Operation Operand 


x,12,13 


tells the assembler it may assume that the current value of the Location 
Counter in general registers 12, incremented by 4096, will be in general 
register 13 at object time. 


If the programmer changes the value in a base register currently being 

used, and wishes the assembler to compute displacement from this value, 

the assembler must be told the new value by means of another USING statement. 
In the following sequence the assembler first assumes that the value of 
ALPHA is in register 9. The second statement then causes the assembler 

to assume that ALPHA+1000 is the value in register 9. 


ALPHA, 9 
ALPHA+1000, 9 


If the programmer has to refer to the first 4096 bytes of virtual memory, he 
can use general register 0 as a base register subject to the following 
conditions: 


1. The value of operand v must be either absolute or relocatable zero or 
simply relocatable, and 


2. register 0 must be specified as operand rl. 
The assembler assumes that register 0 contains zero. Therefore, regardless 
of the value of operand v, it calculates displacements as if operand v were 
absolute or relocatable zero. The assembler also assumes that subsequent 
registers specified in the same USING statement contain 4096, 8192, etc. 
Note: 
If register 0 is used as a base register, the program is not relocatable, 
despite the fact that operand v may be relocatable. The program can be 
made relocatable by: 
1. Replacing register 0 in the USING statement. 


2. Loading the new register with a relocatable value. 


3. Reassembling the program. 
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© 3.12.2 DROP - Drop Base Register 
The DROP instruction specifies a register that was previously available and 


may no longer be used as a base register. 


The typical form of the DROP instruction statement is as follous: 


Not DROP Up to 16 absoiute expressions 
used of the form rl,r2,r3,...,r16 or blank 


The expressions indicate general registers previously specified in a USING 
statement that are now unavailable for base addressing. The following 
statement, for example, prevents the assembler from using registers 7 and 
1l for base addressing: 


DROP 7,11 


It is not necessarv to use a DROP statement when the base address in a 
register is changed bv a USING statement; nor are DROP statements needed at 
the end of the source program. If a register that is not specified in a 
USING statement is used as an operand of a DROP statement, then an error 
flag is set. 


A register made unavailable bv DROP instruction can be made available 
again by a subsequent USING instruction. DROP with blank operand field 
releases all base registers. 


Programming with the USING instruction 


The USING and DROP instructions may be used anywhere in a program, as often 
as needed, to indicate the general registers that are available for use as 
base registers and the base address values the assembler may assume each 

C contains at execution time. Whenever an address is specified in a machine 
instruction statement, the assembler determines whether there is an available 
register containing a suitable base address. A register is considered 
available for a relocatable address if it was assigned a relocatable value 
that is in the same control section as the address. A register assigned an 
absolute value is available for addressing absolute locations only. In either 
case, the base address is considered suitable only if it is less than or equal 
to the address of the item to which the reference is made. The difference 
between the two addresses may not exceed 4095 bytes. In calculating the base 
register to be used, the assembler always uses the available register giving 
the smallest displacement. If there are two registers with the same value, the 
register with the higher number is used. 
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BEGIN 2,0 
x,2 
FIRST 
LAST 
BEGIN 


In the preceding sequence, the BALR instruction loads register 2 with the 
address of the first storage location immediately following. In this case, it 
is the address of the instruction named FIRST. The USING instruction 
indicates to the assembler that register 2 contains this location. When 
employing this method, the USING instruction must immediately follow the 
BALR instruction. No other USING or load instructions are required if the 
location named LAST is within 4095 bytes of FIRST. 


If operand v of a USING statement specifies an absolute value, the assembler 
will use the associated base registers only for operands which represent 
absolute values. In the absence of a base register containing a suitable 
absolute value, an operand whose absolute value is less than 4096 will be 
assembled with general register 0 as base register and its value as 
displacement. Thus, a base register does not have to be explicitly stated for 
the operands of shift-type instructions, for example. 


In Table 3-1, the BALR and LM instructions load registers 2-5. The USING 
instruction indicates to the assembler that these registers are available 
as base registers for addressing a maximum of 16,384 consecutive bytes of 
storage, beginning with the location named HERE. The number of addressable 
bytes may be increased or decreased by altering the number of registers 
designated by the USING and LM instructions and the number of address 
constants specified in the DC instruction. 


BEGIN 2,0 
HERE, 2, 3, 4,5 
HERE 3,5,BASEADDR 
FIRST 
BASEADDR ACHERE+4096 , HERE*8 192 , HERE* 12288) 
FIRST 
LAST 


BEGIN 


Table 3-1: Multiple Base Register Assignment 
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RELATIVE ADDRESSING 


Relative Addressing is the technique of addressing instructions and data 
areas by designating their location in relation to the Location Counter or to 
some symbolic location. This type of addressing is always in bytes, never in 
bits, words, or instructions. Thus, the expression *+4 specifies an address 
that is four bytes greater than the current value of the Location Counter. In 
the sequence of instructions shown in the following example, the location of 
the CR machine instruction can be expressed in two ways, ALPHA+2 or BETA-4, 
because all of the mnemonics in the example are for 2-byte instructions in 
the RR format. 


ALPHA LR 3,4 
CR 4,6 
BCR 1,14 
BETA AR 2,3 


PROGRAM SECTIONING AND LINKING 


It is often convenient, or necessary, to write a large program in sections. 
The sections may be assembled separately, then combined subsequently into 
one object program. The assembler provides facilities for creating multi- 
sectioned programs and symbolically linking separately assembled programs 
or program sections. The combined number of control sections and dummy 
sections, plus the number of unique symbols in EXTRN statements, V-type 
address constants, symbols in external dummy sections, and dummy registers, 
may not exceed 2500. The total number of control sections, dummy sections and 
common sections may not exceed 512. If the same symbol appears in a V-type 
address constant and in the name field of a CSECT or DSECT statement, it is 
counted as two symbols. 


Sectioning a program is optional, and many programs can best be written 
without sectioning them. The programmer writing an unsectioned program need 
not be concerned with the subsequent discussion of program sections, which 
are called control sections. There is no need to employ the CSECT instruction, 
which is used to identify the control sections of a multisection program. 
Similarly, there is no need to be concerned with the discussion of symbolic 
linkages if the program neither requires a linkage to nor receives a linkage 
from another program. If it is desired to identify the program and/or specify 
a tentative starting location, it may be done by using the START instruction. 
It may also be desirable to employ the dummy section feature obtained by 
using the DSECT instruction. 


Notes? 


- Program sectioning and linking is closely related to the specification 
of base registers for each control section. 


— Sectioning and linking examples are provided under the heading "Addressing 
External Control Sections" (3.19). 
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3.15 CONTROL SECTIONS 2 


The concept of program sectioning is a consideration at coding time, 

assembly time, and load time. To the programmer, a program is a logical unit. 
If it is desired to divide it into sections called control sections, it is 
written in such a way that control passes properly from one section to another 
regardless of the relative physical position of the sections in storage. A 
control section is a block of coding that can be relocated, independently 

of other coding, at load time without altering or impairing the operating 
logic of the program. It is normally identified by the CSECT instruction. 
However, if it is desired to specify a tentative starting location, the 

START instruction may be used to identify the first control section. 


To the assembler, there is no such thing as a program, there is an assembly, 
which consists of one or more control sections. An unsectioned program is 
treated as a single control section. To the Linkage Editor, there are no 
programs, only control sections that must be fashioned into an object program. 


3.15.1 Control Dictionary 


The output of the assembler consists of the assembled sections and a 
control dictionary. The control dictionary contains information which the 
Linkage Editor needs in order to complete cross-referencing between control 
sections, as it combines them into an object program. The Linkage Editor 
can take control sections from various assemblies and combine them properly 
with the help of the corresponding control dictionaries. Successful 
combination of separately assembled control sections depends on the 
techniques used to provide symbolic linkages between the control sections. 


Regardless of the degree to which a program is sectioned, the programmer still 
knows that it will eventually be placed in virtual storage as it was 
symbolically described. It is impossible to predict the exact location of 
individual control sections, since the virtual storage location assignments 
may be modified by the Linkage Editor or the Loader, and their physical 
location may be constantly changing within the time sharing environment. 


3.15.2 Control Section Location Assignment 


Control section contents can be intermixed because the assembler provides a 
Location Counter for each control section. Control sections are assigned 
starting locations consecutively, in the same order as the control sections 
first occur in the program. Each control section subsequent to the first 
begins at the next available double-word boundary unless the PAGE attribute 
is specified (see also Attributes of Control Sections, 3.17). 
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ç 3.16 FIRST CONTROL SECTION 


The first control section of a program has the following special properties: 


1. The initial value of its virtual storage location counter mav be specified 
as an absolute value. 


2. It normally contains the literals requested in the program, although 
their positioning can be altered. This is further explained under the 
discussion of the LTORG assemblv instruction. 


3.16.1 START - Start Assembly 


The START instruction may be used to give a name to the first (or only) 
C control section of a program. It may also be used to specify the initial 
value of the location counter for the first control section of the program. 


The typical form of the START instruction statement is as follows; 


A symbol START A self-defining term or blank; may be followed 
or blank optionally by one or more attribute names 
(separated by a comma) 


If a symbol names the START instruction, the symbol is established as the 
name of the control section. If not, the control section is considered to be 
unnamed. All subsequent statements are assembled as part of that control 
section. This continues until a CSECT instruction identifying a different 
control section or a DSECT instruction is encountered. 
A CSECT instruction named by the name symbol that names a START instruction 
is considered to identify the continuation of the control section first 
identified by the START. Similarly, an unnamed CSECT that occurs in a program 
© initiated by an unnamed START is considered to identify the continuation of 
the unnamed control section. 


The symbol in the name field is a valid symbol whose value represents the 
address of the first byte of the control section. It has a length of one. 


The assembler uses the self-defining term specified by the operand as the 
initial value of the location counter of the program. This value should be 
divisible by eight. If the value is not divisible by eight, the location 
counter is set at the next double-word boundary. For example, either of the 
following statements: 
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PROG2 START 2040 
PROG2 START X*7F8* 


could be used to assign the name PROG2 to the first control section and to 
indicate an initial assembly location of 2040. If the first operand is 
omitted, the assembler sets the initial value of the location counter to 
zero. This operand may not be omitted if one or more attribute names follow 
(e.g. START O, READ). 


Note: 
The START instruction may not be preceded by any type of assembly 


language statement that may either affect or depend upon the setting of 
the location counter. 


3.16.2 CSECT - Identify Control Section 


The CSECT assembly instruction identifies the beginning or the continuation 
of a control section. 


The format of the CSECT assembly statement is as follows? 


A symbol CSECT One or more attribute names or blank 
or blank 


If a symbol names the CSECT instruction, the symbol is established as the 
name of the control section; otherwise the section is considered to be 
unnamed. All statements following the CSECT are assembled as part of that 
control section until a statement identifying a different control section is 
encountered (i.e., another CSECT or a DSECT instruction). 


The symbol in the name field is a valid relocatable symbol whose value 
represents the address of the first byte of the control section. It has a 
length attribute of one. The attributes of the control sections are 
described in section 3. 17. 


Several CSECT statements with the same name may appear within a program. The 
first is considered to identify the beginning of the control section; the 
rest identify the resumption of the section. Thus, statements from different 
control sections may be interspersed with one another. They are properly 
assembled (assigned contiguous storage locations) as long as the statements 
from the various control sections are identified by the appropriate CSECT 
instructions. 
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S 3.16.3 Unnamed Control Section 


If neither a named CSECT instruction nor START instruction appears at the 
beginning of the program, the assembler assumes that it is to assemble an 
unnamed control section as the first (or only) control section. There may 
be only one unnamed control section in a program. If one is initiated and 
is then followed by a named control section, any subsequent unnamed CSECT 
statements are considered to resume the unnamed control section. If it is 
desired to write a small program that is unsectioned, the program does not 
need to contain a CSECT instruction. 


3.16.4 DSECT - Identify Dummy Section 


A dummy section represents a control section that is assembled but is not 
part of the object program. A dummy section is a convenient means of 
describing the layout of an area of storage without actually reserving the 

S storage. (It is assumed that the storage is reserved either bv some part of 
this assembly or else by another assembly). The DSECT instruction identifies 
the beginning or resumption of a dummy section. More than one dummy section 
may be defined per assembly, but each must be named. 


The typical form of the DSECT instruction is as follows: 


A symbol DSECT Not used; should be blank 


The symbol in the name field is a valid relocatable symbol whose value 
represents the first byte of the section. It has a length attribute of one. 


Program statements belonging to dummy sections may be interspersed 

throughout the program or may be written as a unit. In either case, the 

appropriate DSECT instruction should precede each set of statements. When 

multiple DSECT instructions with the same name are encountered, the first is 
© considered to initiate the dummy section and the reset to continue it. 


Symbols that name statements in a dummy section may be used in USING 
instructions. Therefore, they may be used in machine instructions and data 
definitions where implicit addressing is desired. An example illustrating 
the use of a dummy section appears subsequently under "Addressing Dummy 
Sections". 


Note: 
A symbol that names a statement in a dummy section may be used in an 
A-type address constant in a DSECT, only if it is paired with another 


symbol (with the opposite sign) from the same dummy sections; i.e., only 
if the constant is made non-relocatable. 
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Dummy Section Location Assignment: 


A Location Counter is used to determine the relative locations of named 
program elements in a dummy section. The Location Counter is always set to 
zero at the beginning of the dummy section, and the location values assigned 
to symbols that name statements in the dummy section are relative to the 
initial statement in the section. 


Addressing Dummy Sections: 


The programmer may wish to describe the format of an area whose storage 
location will not be determined until the program is executed. He can 
describe the format of the area in a dummy section, and he can use symbols 
defined in the dummy section as the operands of machine instructions. To 
effect references to the storage area, he does the following: 


1. Provides a USING statement which specifies a general register available 
as a base register and a value defined in the DSECT that the assembler 
may assume the register contains when resolving symbolic references to 
the DSECT. 


2. Ensures that the same register is loaded with the actual address of 
the storage area. 


The values assigned to symbols defined in a dummy section are relative to the 
initial statement of the section. 

Thus, all machine instructions which refer to names defined in the dummy 
section will, at execution time, refer to storage locations relative to the 
address loaded into the register. 


An example is shown in the following coding. Assume that two independent 
assemblies (assembly 1 and assembly 2) have been loaded and are not to be 
executed as a single overall program. Assembly 1 is an input routine that 
places a record in a specified area of storage, places the address of the 
input area containing the record in general register 3, and branches to 
assembly 2. Assembly 2 processes the record. The coding shown in the example 
is from assembly 2. 


The input area is described in assembly 2 by the DSECT control section 

named INAREA. Portions of the input area (i.e., record) that the programmer 
wishes to work with are named in DSECT control section as shown. The assembly 
instruction USING INAREA,3 designates general register 3 as the base register 
to be used in addressing the DSECT control section, and that general register 
3 is assumed to contain the address of INAREA. 


Assembly 1, during execution, loads the actual beginning address of the input 
area in general register 3. Because the symbols used in the DSECT section are 
defined relative to the initial statement in the section, the address values 
they represent, will, at the time of program execution, be the actual storage 
locations of the input area. 
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ASMBLY2 
BEGIN 2,8 
x,2 
INAREA,3 
INCODE,C'A' 
ATYPE 
ATYPE WORKA, INPUTA 
WORKB, INPUTB 
HORKA CL20 
© WORKB CL18 
INAREA 
INCODE CL1 
INPUTA CL20 
INPUTB CL18 
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3.16.5 COM - Define Blank Common Control Section 


The COM assembly instruction identifies and reserves a common area of 
storage that may be referred to by independent assemblies that have been 
linked and loaded for execution as one overall program. 


More than one COM statement may appear within a program (see the previous 
discussion of PROGRAM SECTIONING for restrictions). A COM statement with the 
same name as an earlier one indicates the resumption of this section. Blank 
common is interpreted as having a name consisting entirely of spaces. Thus, 
only one blank common may be designated in an assembly. 


When several assemblies are loaded, all of which have common control sections, 
the amount of storage reserved is equal to the longest common control 
section. 


The format of the COM statement is as follows: 


A symbol COM One or more attribute names or blank 
or blank 


The common area may be broken up into subfields through the use of the DS 
and DC assembly instructions. Names of subfields are defined relative to the 
beginning of the common section, as in the DSECT control section. 


No instructions or constants appearing in a common control section are 
assembled. Data can only be placed in a common control section through 
execution of the program. 


If the assignment of common storage is done in the same manner by each 
independent assembly, reference to a location in common by any assembly 
results in the same location being referenced. 


When assembled, common location assignment starts on the next available 
double word (or page) boundary following the last CSECT. 


A common control section may be assigned attributes in the same manner as a 
CSECT. 


3-36 Assembler V29.1C, U62-J-255-6-7?600 


Program section 


© 3.16.6 XDSEC — Identifv External Dummv Section 


The XDSEC instruction has the following format: 


NAME XDSEC DLEFINITIONI/RLEFERENCE] 


The rules for the dummy section as described under 3.16.4 also apply to the 
external dummy section, with the following exceptions: 


To define an external dummy section (XDSEC D) external information is 
transferred to the Linkage Editor, which uses this information to process the 
external information which is output as a reference to an external dummy 
section (XDSEC R) in another program. In the reference to an external dummy 
section (XDSEC R) the Location Counter is set to zero and remains zero 
throughout the whole section. The real Location Counter of a symbol in a 
reference to an external dummy section is entered by the Linkage Editor in the 
S instruction using this svmbol. 


Thus, it is the Linkage Editor and not the assembler which evaluates the 
Location Counter for symbols in an XDSEC R. This has the advantage that 
modifying a symbol in an XDSEC D entails the reassemblv of only those modules 
which use the symbol to be modified, and not of all the modules using this 
XDSEC. 

EQU statements are not permitted in XDSEC. 


Expressions in the operand field of an EQU statement outside of an XDSEC must 
not be a difference of XDSEC elements. 
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Example of 


XDSEC 


SIEMENS F-ASSEMBLER LISTING 


SYMBOL TYPE ID 
PROGI SD 
PROG2 VC 0002 
PROG3 VC 0003 
(DUMMY) EINGABE XD 
VORNAME XD 
NAME XD 
FLAG LOCTN OBJECT CODE 
000000 
000000 05 20 
000002 
000000 
000002 41 DO 2024 000026 
000006 58 FO 2042 000044 
00000A 05 EF 
00000C 58 FO 2046 000048 
000010 05 EF 
000012 
000026 C1D5E3D6D5404040 
000044 00000000 
000048 00000000 
000000 
000000 
00000A 


3-38 


ADDR LENGTH 


0001 00000 0004C 


0004 00000 0001E 


0005 00000 0000A 
0006 0000A 00014 


EXTERNAL SYMBOL DICTIONARY 


PROG1 


EININF 
VPROG2 
VPROG3 
x 


EINGABE 
VORNAME 


NAME 


CSECT 
PRINT 
BALR 
USING 
USING 
LA 

L 
BALR 
L 
BALR 
TERM 


DC 
DC 
DC 


XDSEC 
DS 

DS 
END 


ADDR1 ADDR2 STMNT M SOURCE STATEMENT 


NOGEN 
2,0 

x, 2 

EINGABE, 13 

13, EININF 

15, VPROG2 2 
14,15 

15 ,VPROG3 

14,15 


NK VERSION 702 
СЗО" ANTON 
VCPROG2) 
VCPROG3) 


MUELLER" 


D 
CL10 
CL20 
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SIEMENS F-ASSEMBLER LISTING 


SYMBOL 


PROG2 
(DUMMY) EINGABE 
VORNAME 


FLAG LOCTN OBJECT CODE 


000000 
000000 
000000 


TYPE ID ADDR LENGTH 


SD 0001 00000 00012 
XR 0002 00000 00000 
XR 0003 00000 0000A 


000000 рг 09 F008D000 000008 000000 


000006 07 FE 
000008 


000000 
000000 


SIEMENS F-ASSEMBLER LISTING 


SYMBOL 


PROG3 
(DUMMY) EINGABE 
NAME 


FLAG LOCTN OBJECT CODE 


000000 
000000 
000000 


TYPE ID ADDR LENGTH 


SD 0001 00000 0001C 
XR 0002 00000 00000 
XR 0003 00000 00014 


000000 D2 13 F008D000 000008 000000 


000006 07 FE 
000008 


000000 
000000 


н O 0 0 ^J O* U P: 0i I) & 


— — 


= O 0 ^4 O* Ui 4 OI N н 


= — 


Program section 


EXTERNAL SYMBOL DICTIONARY 


ADDR1 ADDR2 STMNT M SOURCE STATEMENT 


XXXXXXXXX%XXXXXXXXXXXXXXXXXXXXXXXX 
PROG2 СЅЕСТ 
USING x,15 
USING EINGABE, 13 
MVC AUSVN,VORNAME 
BR 1⁄4 
AUSVN DS CL10 
x 


EINGABE XDSEC R 
VORNAME DS CL10 
END 


EXTERNAL SYMBOL DICTIONARY 


ADDR1 ADDR2 STMNT M SOURCE STATEMENT 


HHH HEHEHE HEHEHE HE HEHEHE HEHEHE ЭЄ HEHEHE HEH € CC € € € 3€ 3€ 3€ 3X 
PROG3 csc 
USING *, 15 
USING EINGABE, 13 
MVC AUSNAHME ‚NAME 
BR 14 
AUSNAME DS CL20 
ж 


EINGABE  XDSEC R 
NAME . DS CL20 
END 


PROG1 initializes the input information and defines the format of this 


information. 


PROG2 processes the information VORNAME from the input information. 

PROG3 processes the information NAME from the input information. The complete 
format of the input information is not known in PROG2 and PROG3, which only 
require the format of the used symbols from the input information. 
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3-17 ATTRIBUTES OF CONTROL SECTIONS 


To facilitate dynamic linkage and loading, it is often necessary to indicate 
that certain attributes are characteristic of all data and instructions 
within a control section. The following attributes may be specified (in any 
order) in the operand field of CSECT and COM statements: 


PUBLIC indicates that the section contains shared, public data 
or instructions. 


READ indicates that the section is never modified (read only). 


PRVLGD indicates that the section is to be assigned a protection 
key so that only privileged system service routines 
have read or write access to it. 


PAGE indicates that the section is to begin at a page boundary 
which is a multiple of 4096. 


RESIDENT indicates that the specified section is loaded in 
class-3 memory and held resident there. 


Attributes may be specified singly or in combination. The final set of 
attributes of a control section is determined by combining all attributes. 
The attributes may appear in the statement which defines the beginning of 
the control section and in any statements used to resume it. It is not 
necessary to repeat attributes for statements having identical names. 
However, for program documentation in the assembly listing it may be useful 
to repeat attributes in continuation sections. If no attributes are 
specified, the control section will be considered private, modifiable and 
double word oriented. Attribute information will be output for each control 
section as part of the object module. 
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© 3.18 SYMBOLIC LINKAGE 


Symbols may be defined in one program and referred to in another, thus 
effecting symbolic linkages between independently assembled programs. The 
linkages can be effected only if the assembler is able to provide 
information about the linkage symbols to the Linkage Editor, which resolves 
these linkage references at load time. The assembler places the necessary 
information in the control dictionary, on the basis of the linkage symbols 
identified by the ENTRY and EXTRN instructions. Note that these symbolic 
linkages are described as linkages between independent assemblies; more 
specifically, they are linkages between independently assembled control 
sections. 


In the program where the linkage symbol is defined (i.e., used as a name), 

it must also be identified to the Linkage Editor and assembler by means of 

the ENTRY assembly instruction. It is identified as a symbol that names an 

entry point, which means that another program may use that symbol in order 

to effect a branch operation or a data reference. The assembler places this 
© information in the control dictionary. 


Similarly, the program that uses a symbol defined in some other program must 
identify it by the EXTRN assembly instruction. Since the definition of the 
symbol appears in another program, the assembler arbitrarily assigns a length 
attribute of 1 and a value of 0. The assembler places this information in 

the control dictionary. 


Another way to obtain symbolic linkages is by using the V-type address 
constant. The subsection "Data Definition Instructions" contains the 
details pertinent to writing a V-type address constant. It is sufficient 
here to note that this constant may be considered an indirect linkage point. 
It is created from an externally defined symbol, but that symbol does not 
have to be identified by an EXTRN statement. The V-type address constant is 
intended to be used for external branch references (i.e., for effecting 
branches to other programs). Therefore, it may not be used for external data 
references (i.e., for referring to data in other programs). 


Ç 3.18.1 ENTRY — Identify Entry-Point Symbol 
The ENTRY assembly instruction identifies linkage symbols that are defined 
in one program but which may be used by other programs. 


The format of the ENTRY instruction statement is as follows: 


Name Operation Operand 


Not ENTRY One or more relocatable symbols, separated 


used by commas, that also appear as statement names 


The number of ENTRY symbols is not limited. 


An ENTRY statement operand may not contain a symbol defined in a dummy 
section or blank common or unnamed CSECT. An ENTRY statement containing a 
symbol defined in an unnamed control section can be processed by the 
assembler, but the Linkage Editor will not process the resulting object 


C module. 
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The following example identifies the statements named SINE and COSINE | 2 
as entry points to the program. 


Name Operation Operand 


ENTRY SINE,COSINE 


Notes: 


— The name of a control section does not have to be identified by an ENTRY 
statement when another program uses it as an entry point. The assembler 
automatically places information on control section names in the control 
dictionary. 


- Declaring a name as an ENTRY point does not constitute a definition for 
this name. The name will not be defined unless it appears in the name 
of an assembly or machine instruction. The length attribute of a symbol 
named in an ENTRY statement is therefore determined by the type of 
statement used to define it. The same symbol may not be used in the 
operand field of both an EXTRN and an ENTRY statement in the same assembly. 2 


3.18.2 EXTRN - Identify External Symbol 


The EXTRN assembly instruction identifies linkage symbols that are used by 
this program but defined in some other program. Each external symbol must 
be identified; this includes symbols that name control sections. 


The typical form of the EXTRN instruction statement is as follous: 


Not EXTRN One or more relocatable symbols, separated by 
used commas. 
The symbols in the operand field may not appear as names of statements in 2 


this program. The following example identifies three external svmbols that 
have been used as operands in this program but are defined in some other 
program. 


Name Operation Operand 


EXTRN RATEBL, PAYCALC 
EXTRN WITHCALC 


A symbol declared as an EXTRN is considered defined after that point and may 
therefore be used wherever a storage address is desired. However, a 
separate USING statement is required for every external symbol used in this 
manner (note the second example in the following discussion). A symbol may 
be redundantly declared as an external symbol in more than one EXTRN 
statement. The length attribute of an external symbol is 1. 


An example using the EXTRN instruction appears subsequently in section 3.19 
under "Addressing External Control Sections". 2 
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© Notes: 


1. A V-type address constant must not be identified by means of 
EXTRN statements. 


2. When external symbols are used in an expression, they may not be paired. 
Each external symbol must be considered as having a unique relocatability 
attribute. 


3.18.3 WXTRN - Identify Conditional External Symbol 


The WXTRN statement can be used instead of the EXTRN statement. HWhen it is 
used, the automatic scanning of the module library for corresponding 
definitions by the Linkage Editor is suppressed. WXTRN symbols are resolved 
only if a corresponding definition is found by other control mechanisms 
during linking (e.g. by explicit linking with the INCLUDE statement). 


S The format of the WXTRN instruction statement is as follows: 
Not WXTRN One or more symbols separated by commas 
Used 


In all other respects the rules for the EXTRN statement apply. 
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3.19 ADDRESSING EXTERNAL CONTROL SECTIONS 9 


A common wav for a program to link to an external control section is to: 
1. Create a V-type address constant with the name of the external symbol. 


2. Load the constant into a general register and branch to the control 
section via the register. 


The combined number of control sections and dummy sections plus the number 
of unique symbols in EXTRN statements, V-type address constants, symbols in 
external dummy sections, and dummy registers, must not exceed 2500. If the 
same symbol appears in a V-type address constant and in the name entry of a 
CSECT or DSECT statement, it is counted as two symbols. 


MAINPROG | CSECT 
BEGIN BALR 2,0 ә 
USING x,2 
L 3, VCON 
BALR 1,3 
VCON DC VCSINE) 
END 


For example, to link to the control section named SINE, the preceding coding 
might be used. 


An external symbol naming data may be referred to as follows: 
l. Identify the external symbol with the EXTRN instruction, and create 


an address constant from the symbol. 


2. Load the constant into a general register, and use the register for 
base addressing. 2 
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© For example, to use ап area named RATETBL, which is in another control 
section, the following coding might be used: 


MAINPROG 
BEGIN 


ж N 
` s 
N O 


RATETBL 


4 , RATEADDR 
RATETBL, 4 
3, RATETBL 


ACRATETBL) 
BEGIN 


RATEADDR 
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3.20 MACHINE INSTRUCTION STATEMENTS 


This section discusses the coding of the machine instructions represented in 
the assembly language. The reader is reminded that the functions of each 
machine instruction are discussed in the Processor Reference Manual. 


Machine instructions may be represented symbolically as assembly language 
statements. The symbolic format of each varies according to the actual 
machine instruction format, of which there are five: RR, RX, RS, SI, and SS. 
Within each basic format, further variations are possible. 


The symbolic format of a machine instruction is similar to, but does not 
duplicate, its actual format. A mnemonic operation code is written in the 
operation field, and one or more operands are written in the operand 
field. Comments may be appended to a machine instruction statement as 
explained under "Comments Entries". 


Any machine instruction statement may be named by a symbol, which other 
assembly statements can use as an operand. The value attribute of the 
symbol is the address of the leftmost byte assigned to the assembled 
instruction. The length attribute of the symbol depends on the basic 
instruction format, as follows: 


Basic Format Length Attribute 
RR e 
RX а 
RS 4 
SI 6 
SS 6 


3.20.1 Instruction Alignment and Checking 


All machine instructions are aligned automatically by the assembler on 
halfword boundaries. If any statement that causes information to be assembled 
requires alignment, the bytes skipped are filled with hexadecimal zeros. 

All expressions that specify storage addresses are checked to insure that 
they refer to appropriate boundaries for the instructions in which they are 
used. Register numbers are also checked to make sure that they speci fy 

the proper registers, as follows: 


1. Floating-point instructions must specify floating-point registers 0, 2, 4 
or 6. 


2. Double-shift, full-word multiply, and divide instructions must specify 
an even-numbered general register in the first operand. 
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ç 3.21 OPERAND FIELDS AND SUBFIELDS 


Some symbolic operands are written as a single field and other operands 

are written as a field followed by one or two subfields. For example, 
addresses consist of the contents of a base register and a displacement. An 
operand that specifies a base and displacement is written as a displacement 
field followed by a base register subfield, as follows: 40(5). In the 

RX format, both an index register subfield and a base register subfield are 
written as follows: 40(3,5). In the SS format, both a length subfield and a 
base register subfield are written as follows: 40(21,5). 


Table 3-2 shows two types of addressing formats for RX, RS, SI and SS 
instructions. In each case, the first type shows the method of specifying an 
address explicitly, as a base register and displacement. The second type 
indicates how to specify an implied address as an expression. 


For example, a load multiple instruction (RS format) may have either of the 
following symbolic operands: 


ç R1,R3,D2(B2) explicit address 
R1,R3,S2 implied address 


Whereas D2 and B2 must be represented by absolute expressions, S2 may be 
represented either by a relocatable or an absolute expression. 


In order to use implied addresses, the following rules must be observed: 
l. The base register assembly instructions (USING and DROP) must be used. 


2. An explicit base register designation must not accompany the implied 
address. 


For example, assume that FIELD is a relocatable symbol, which has been 
assigned a value of 7400. Assume also that the assembler has been notified 
(by a USING instruction) that general register 12 currently contains a 
relocatable value of 4096 and is available as a base register. The following 
example shows a machine instruction statement as it would be written in 
assembly language and as it would be assembled. Not that the value of D2 is 
the difference between 7400 and 4096 and that X2 is assembled as zero, since 
C it was omitted. The assembled instruction is presented in hexadecimal: 


Assembly statement: 
ST 4,FIELD 
Assembled instruction: 


OP Code R1 X2 B2 D2 
50 4 0 C CE8 
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An address may be specified explicitly as a base register and displacement 
(and index register for RX instructions) by the formats shown in the first 
column of table 3-2. The address may be specified as an implied address by the 
formats shown in the second column. Observe that the two storage addresses 
required by the SS instructions are presented separately; an implied address 
may be used for one while an explicit address is used for the other. 


Type Explicit Address Implied Address 


RX D2(X2,B2) S2(X2) 
D2( ,B2) 82 

RS D2(B2) S2 

SI D1(B1) 81 

88 D1(L1,B1) S1(L1) 
D1(L,B1) S1(L) 
D2(L2,B2) S2(L2) 


Table 3-2: Details of Address Specification 


A comma must be written to separate operands. Parentheses must be written 
to enclose a subfield or subfields, and a comma must be written to separate 
two subfields within parentheses. When parentheses are used to enclose one 
subfield, and the subfield is omitted, the parentheses must be omitted. In 
the case of tuo subfields that are separated by a comma and enclosed in 
parentheses, the following rules apply: 


1. If both subfields are omitted, the separating comma and the parentheses 
must also be omitted. 


Example 
L 2,48(4,5) 
L 2,FIELD (implied address) 


2. If the first subfield in the sequence is omitted, the comma that separates 
it from the second subfield is written. The parentheses must also be 


written. 
Example 
MVC 32( 16,5) , FIELD2 
MVC 320,5, FIELD2 (implied length) 


j. If the second subfield in the sequence is omitted, the comma that 
separates it from the first subfield must be omitted. The parentheses must 
be written. 


Example 
MVC 32( 16,5) , FIELD2 
MVC FIELD1(16) ,FIELD2 (implied length) 


Fields and subfields in a symbolic operand may be represented either by 
absolute or by relocatable expressions, depending on what the field requires. 
(An expression has been defined as consisting of one term or a series of 
arithmetically combined terms). Refer to Tables 3-2 and 3-3 for a detailed 
description of field requirements. 
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© Note: 


Blanks may not appear in an operand unless provided by a character 
self-defining term or a character literal. Thus, blanks may not intervene 
between fields and the comma separators, between parentheses and fields, 
etc. 
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3.22 LENGTHS - EXPLICIT AND IMPLIED 2 


The length field in SS instructions can be explicit or implied. To imply a 
length, the programmer omits a length field from the operand. The omission 
indicates that the length field is either of the following: 


1. The length attribute of the expression specifying the displacement, if 
an explicit base and displacement have been written. 


2. The length attribute of the expression specifying the effective address, 
if the base and displacement have been implied. 


In either case, the length attribute for an expression is the length of the 
leftmost term in the expression. The length attribute of asterisk (ж) is 
equal to the length of the instruction in which it appears, except in an 
EQU statement (see 3.26). 


By contrast, an explicit length is written by the programmer in the operand as 
an absolute expression. The explicit length overrides any implied length. Ээ 


Whether the length is explicit or implied, it is always an effective length. 
The value inserted into the length field of the assembled instruction is one 
less than the effective length in the source program statement. 


Note: 


If a length of zero is desired, the length may be stated as zero or one. 


To summarize, the length required in an SS instruction may be specified 
explicitly by the formats shown in the first column of Table 3-3 or may be 
implied by the formats shown in the second column. Observe that the two 
lengths required in some of the SS instruction formats are presented 
separately. An implied length may be used for one while an explicit length is 
used for the other. 


Explicit Length Implied Length 

D1(L1,B1) D1C,B1) 3 
S1(L1) Sl 

D1(L,B1) D1C,B1) 

S1(L) S1 

D1(L2,B2) D1C,B2) 

S2(L2) S2 


Table 3-3: Details of Length Specification in SS Instructions 
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3.23 MACHINE INSTRUCTION MNEMONIC CODES 


The mnemonic operation codes (shown in Appendices A-6 and A-7) are designed 
so that their functions can be easily remembered. The normal format of the 
code is shown below; the items in brackets are not necessarily present in 
all codes: 


Verb [Modi fier IIData Type][Machine Format] 


The verb, which is usually one or two characters, specifies the function. 

For example, A represents Add, and MV represents Move. The function may be 
further defined by a modifier. For example, the modifier L indicates a logical 
function, as in AL for Add Logical, and MV is modified by C (MVC) to indicate 
Move Characters. 


Mnemonic codes for functions involving data usually indicate the data types, 
by letters that correspond to those for the data types in the DC assembly 
instruction. 


Furthermore, letters U and W have been added to indicate short and long, 
unnormalized floating-point operations, respectively. For example, AE 
indicates Add Normalized Short, whereas AU indicates Add Unnormalized Short. 
Where applicable, full-word fixed-point data is implied if the data type is 
omi tted. 


The letters R and I are added to the codes to indicate, respectively, RR and 
SI machine instruction formats. Thus, AER indicates Add Normalized Short in 
the RR format. Functions involving character and decimal data types imply 
the SS format. 
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3.24 MACHINE INSTRUCTION EXAMPLES 


The examples that follow are grouped according to machine instruction 
format. They illustrate the various symbolic operand formats. All symbols 
employed in the examples must be assumed to be defined elsewhere in the same 
assembly. All symbols that specify register numbers and lengths must be 
assumed to be equated elsewhere to absolute values (EQU instruction). 


Implied addressing, control section addressing, and the function of the USING 
assembly instruction are not considered here. For discussion of these 
considerations and for examples of coding sequences that illustrate them, 
refer to section 3.14, Program Sectioning and Linking and section 3.12, Base 
Register Instruction. 


RR-Format: 

ΑΙ ΡΗΑΙ 1,2 
ALPHA2 REG1,REG2 
BETA 15 

GAMMA1 250 
GAMMA2 TEN 


The operands of ALPHA1, BETA, and GAMMAl are decimal self-defining values, 
which are categorized as absolute expressions. The operands of ALPHA2 and 
GAMMA2 are symbols that are equated elsewhere to absolute values. 


RX-Format : 

ΑΙ ΡΗΑΙ L 1,39(4,10) 

ΑΙ ΡΗΑΟ L REG1,39(4,TEN) 
ΒΕΤΑΙ L 2,ZETA(4) 

BETA2 L REG2, ZETA( REG4) 
GAMMA1 L 2,ZETA 

GAMMA2 L REG2, ZETA 
GAMMA3 L 2,ΞΕ 1000" 
LAMBDA1 L 3,20(,5) 


Both ALPHA instructions specify explicit addresses; REG1 and TEN are 
absolute symbols. Both BETA instructions specify implied addresses, and both 
use index registers. Indexing is omitted from the GAMMA instructions. 


GAMMA1 and GAMMA2 specify implied addresses. The second operand of GAMMA3 is a 


literal. LAMBDAl specifies no indexing. 
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C RS-Format: 
ALPHA1 1,2,20(14) 
ALPHA2 REG1, REG2, 20( REGD) 
ALPHA3 REG1,REG2,ZETA 
ALPHA4 REG2, 15 
ALPHA5 REG2, 0( 15) 


Whereas ALPHAl and ALPHA2 specify explicit addresses, ALPHA3 specifies an 
implied address. ALPHA4 is a shift instruction shifting the contents of 
REG2 left 15 bit positions. ALPHA5 is a shift instruction shifting the 
contents of REG2 left by the value contained in general register 15. 


SI-Format 

ALPHA1 40(9) ,X' 40' 
ALPHA? 40(REG9) , TEN 
BETA1 ZETA, TEN 
BETA2 ZETA,C"A" 
GAMMA1 4009) 

GAMMA2 0(9) 

GAMMA3 40(0) 

GAMMA4 ZETA 


The ALPHA instructions and GAMMA1-GAMMA3 specify explicit addresses, whereas 
the BETA instructions and GAMMA4 specify implied addresses. GAMMA2 specifies 
a displacement of zero. GAMMA3 does not specify a base register. 


SS-Format : 


ALPHA1 40(9,8) ,30(6,7) 

ALPHA2 40(NINE, REG8) , 30(L6, 7) 
ALPHA3 FIELD2,FIELD1 

ALPHA4 FIELD2(9) ,FIELD1(6) 
BETA FIELD2(9) ,FIELDI 
GAMMA1 40(9,8),30(7) 

GAMMA2 40(NINE, REG8) , DEC 
GAMMA3 FIELD2,FIELD1 

GAMMA FIELD2(9) ,FIELD1 


ALPHA1, ALPHA2, GAMMA1 and GAMMA2 specify explicit lengths and addresses. 
ALPHA3 and GAMMA3 specify both implied length and implied addresses. 
ALPHA4 and GAMMA4 specify explicit lengths and implied addresses. ВЕТА 
specifies an explicit length for FIELD2 and an implied length for FIELD1; 
both addresses are implied. 
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3.26.1 Extended Mnemonic Codes 


For the convenience of the programmer, the assembler provides extended 
mnemonic codes, which allow conditional branches to be specified 
mnemonically as well as through the use of the BC machine instruction. 

These extended mnemonic codes specify both the machine branch instruction 

and the condition on which the branch is to occur. The codes are not part 

of the universal set of machine instructions, but are translated by the 
assembler into the corresponding operation and condition combinations. 

The permissible extended mnemonic codes and their operand formats are 

shown in Table 3-4, together with their machine instructions in the RX format. 
Note that the only difference between the operand fields of the extended 
mnemonics and those of their machine instruction equivalents is the absence 
of the R1 field and the comma that separates it from the rest of the 

operand field. The extended mnemonic list, like the machine instruction list, 
shows explicit address formats only. Each address can also be specified as an 
implied address. 


Unconditional Branch Instructions 


Extended Code r Machine Instruction 


B D2(X2,B2) Branch Unconditional BC 15,D2(X2,B2) 
BR R2 Branch unconditional BCR 15,R2 

( RR-Format) 
МР D2(X2,B2) No operation BC 0,D2(X2,B2) 
NOPR R2 No Operation 


( RR-Format) ВСК 0,R2 


Used After Compare Instructions 


Extended Code Er Machine Instruction 


BH X D2(X2,B2) BC 2,D2(X2,B2) 
BL D2(-X2,B2) BC 4,D2(X2,B2) 
BE D2(X2,B2) BC 8,D2(X2,B2) 
BNH D2(X2,B2) BC 13,D2(X2,B2) 
BNL D2(X2,B2) BC 11,D2(X2,B2) 
BNE D2(X2,B2) BC 7,D2(X2,B2) 


Branch on High 
Branch on Low 
Branch on Equal 
Branch on Not High 
Branch on Not Low 
Branch on Not Equal 


BRH R2 Branch on High 

(RR format) BCR 2,R2 
BRL R2 Branch on Low 

(RR format) BCR 4,R2 
BRE R2 Branch on Equal 

(RR format) BCR 8,R2 
BRNH R2 Branch on Not High 

(RR format) BCR 13,R2 
BRNL R2 Branch on Not Low 

(RR format) BCR 11,R2 
BRNE R2 Branch on Not Equal 

(RR format) BCR 7,R2 
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Used After Arithmetic Instructions 


Extended Code 


BO D2(X2,B2) Branch on Overflow 1,D2(X2,B2) 
BP D2(X2,B2) Branch on Plus 2,D2(X2,B2) 
BM D2(X2,B2) Branch on Minus 4,D2(X2,B2) 
BZ D2(X2,B2) Branch on Zero 8,D2(X2,B2) 
BNP D2(X2,B2) Branch on Not Plus 13,D2(X2,B2) 
BNM D2(X2,B2) Branch on Not Minus 11,D2(X2,B2) 
ΒΝΖ  D2(X2,B2) Branch on Not Zero 7, D2(X2,B2) 
BRO R2 Branch on Overflow 

(RR format) 1,R2 
BRP R2 Branch on Plus 

(RR format) 2,R2 
BRM R2 Branch on Minus 

(RR format) 4, R2 
BRZ R2 Branch on Zero 

(RR format) 8,R2 
BRNP R2 Branch on Not Plus 

(RR format) 13,R2 
BRNM R2 Branch on Not Minus 

(RR format) 11,R2 
BRNZ R2 Branch on Not Equal 

(RR format) 7,R2 


Used After Test Under Mask Instructions 


Extended Code 


Machine Instruction 


BO D2(X2,B2) Branch Ones 1,D2(X2,B2) 
BM D2(X2,B2) Branch Mixed 4,D2(X2,B2) 
BZ D2(X2,B2) Branch Zeros 8,D2(X2,B2) 
BNO D2(X2,B2) Branch Not Ones 14 ,D2(X2,B2) 
BNM D2(X2,B2) Branch Not Mixed 11,D2(X2,B2) 
BNZ  D2(X2,B2) Branch Not Zero ? ,D2( X2,B2) 
BRO R2 Branch Ones 1,R2 

BRM R2 Branch Mixed 4,R2 

BRZ R2 Branch Zeros 8,R2 

BRNO R2 Branch Not Ones 14,R2 

BRNM R2 Branch Not Mixed 11,R2 

BRNZ R2 Branch Not Zeros 7,R2 


Table 3-4: Extended Mnemonic Codes 
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In the following example, which illustrates the use of extended mnemonics ‚К э 
is to be assumed that the symbol GO is defined elsewhere in the program. 


B 
B 


40(3,6) 
40(,6) 
BL 60(3) 
BL GO 
BR á 


The first two instructions specify an unconditional branch to an explicit 

address. The address in the first case is the sum of the contents of base 

register 6, the contents of index register 3, and the displacement 403 

the address in the second instruction is not indexed. The third instruction 

specifies a branch on low to the address implied by GO as indexed by the 

contents of index register 3; the fourth instruction does not specify an 

index register. The last instruction is an unconditional branch to the 

address contained in register 4. э 
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C 3.25 ASSEMBLY INSTRUCTION STATEMENTS 


Just as machine instructions are used to request the computer to perform 

a sequence of operations during program execution time, so assembly 
instructions are requests to the assembler to perform certain operations 
during the assembly. Assembly instruction statements, in contrast to machine 
instruction statements, do not always cause machine instructions to be 
included in the assembled program. Some, such as DS and DC, generate no 
instructions but do cause storage areas to be set aside for constants and 
other data. Others, such as EQU and SPACE, are effective only at assembly 
time; they generate nothing in the assembled program and have no effect on 
the Location Counter. 


The following is a list of all the assembly instructions. 
Symbol Definition Instruction 


ç EQU Equate Symbol 


Data Definition Instructions 


DC Define Constant 

DS Define Storage 

DXD Define Dummv Register 

CXD Define Length of Dummy Register Vector 


Program Sectioning and Linking Instructions 


START Start Assembly 
CSECT Identify Control Section 
DSECT Identify Dummy Section 
C XDSEC Identify External Dummy Section 
ENTRY Identify Entry-Point Symbol 
EXTRN Identify External Symbol 
WXTRN Identify Conditional External Symbol 
COM Identify Blank Common Section 


Base Register Instructions 


Use Base Address Register 
Drop Base Address Register 
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Listing Control Instructions 


TITLE 
EJECT 
SPACE 
PRINT 


Identify Assembly Output 
Start Neu Page 

Space Listing 

Print Optional Data 


Program Control Instructions 


ICTL 
ISEQ 
ORG 
LTORG 
CNOP 
END 
PUNCH 
REPRO 


Other 


COPY 

OPSYN 
STACK 
UNSTK 


Input Format Control 
Input Sequence Checking 
Set Location Counter 
Begin Literal Pool 
Conditional No Operation 
End Assembly 

Qutput in Card Format 
Reproduce Following Card 


Instructions 


Copy Library Member 
Modi fy Mnemonic Code 
Store PRINT, USING status 
Reset PRINT, USING status 
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ç 3.26 SYMBOL DEFINITION INSTRUCTION 


3.26.1 EQU — Equate Symbol 


The EQU instruction is used to define a symbol by assigning to it the 
length, and relocatability attributes of an expression in the operand field. x 


The typical form of the EQU instruction statement is as follows: 


Name Operation Operand 


A symbol An expression 


The expression in the operand field may be absolute or relocatable. Any 
© symbols appearing in the expression must be previously defined. 


The symbol in the name field is given the same attributes as the expression 
in the operand field. The length attribute of the symbol is that of the 
leftmost symbol of a multi-term expression in the operand field. However, 
if the expression in the operand field consists of a % or a self-defining 
term, the length attribute is 1. The value attribute of the symbol is the 
value of the expression. The value of the expression must not be more than 
3 bytes. 


The EQU instruction is the means of equating symbols to register numbers, 
immediate data, and other arbitrary values. The following examples illustrate 
how this might be done: 


REG2 2 (general register) 
TEST X'3F' (immediate data) 
C EQU statements have not yet been evaluated by the assembler when macro 
processing is being performed. 
E.g. 
Name Operation Operand 


και EQU 1 
MAC RG1 


causes the macro MAC to be generated, with the character sequence RG1 as 
operand, but not with 1. 


To reduce programming time, the programmer can equate symbols to frequently 
used expressions and then use the symbols as operands in place of the 
expressions. . 
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Thus, in the statement 


FIELD ALPHA-BETA+GAMMA 


FIELD is defined as ALPHA-BETA+GAMMA and may be used in place of it. 
Note that ALPHA, BETA and GAMMA must all be previously defined. 


3.26.2 EQU — Extended Format 


Two further expressions are permitted in the operand field, the first of 
which specifies the length attribute of the symbol defined and the second one 
its type. Both operands are optional; if they are omitted, the attributes are 
defaulted according to 3.26.1. When specifying the type attribute while 
omitting the length attribute, the two existing expressions must be separated 
by two commas. 


The extended EQU format is this: 


Name expressionl, [expression21, [expression3] 


The length attribute must be an absolute value in the range 0 to 224-1, It 
may be analyzed both at macro language and at actual assembly time. To be 
analyzed as early as at macro processing time, however, the length attribute 
must be a simple decimal self-defining term. 


Notes: 

— When an expression or symbolic parameter is entered for the length, the 
standard value 1 is assigned at macro processing times; thus, different 
values may be assigned during the course of assembly. 

— The type attribute can be evaluated only at macro language time. Therefore, 


it, too, must be specified as a simple self-defining value in the range 
0-255, in character, hexadecimal, binary, or decimal format. 
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Ф 3.27 DATA DEFINITION INSTRUCTIONS 


There are two data definitions instruction statements: 
Define Constant (DC) and Define Storage (DS). 


These statements are used to enter data constants into storage, and to 

define and reserve areas of storage. The statements may be named by symbols 
so that other program statements can refer to the fields generated from 

them. The discussion of the DC instruction is far more extensive than that of 
the DS instruction, because the DS instruction is written in the same format 
as the DC instruction and may specify some or all of the information that the 
DC instruction provides. Only the function and treatment of the statements 
vary. For this reason, the DC instruction is discussed first and in more 
detail than the DS instruction. 
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The DC instruction is used to define data constants in storage. It may 
specify one constant or a series of constants, thereby relieving the 
programmer of the necessity to write a separate data definition statement for 
each constant desired. Furthermore, a variety of constants may be specified: 
fixed-point, floating-point, decimal, hexadecimal, character, and storage 
address. (Data constants are generally called constants unless they are 
created from storage addresses, in which case they are called address 
constants). 


The typical form of the DC instruction statement is as follows? 


Name Operation Operand 


A symbol One or more operands in the format described in 


or blank the following text, each separated by commas. 


Each operand consists of four subfields; the first three describe the 
constant, and the fourth subfield provides the constant or constants. The 
first and third subfields may be omitted, the second and fourth must be 
specified, except for character type constants, in which case only field 4 

is required. Note that more than one constant may be specified in the fourth 
subfield for most types of constants. Each constant so specified must be of 
the same type; the descriptive subfields that precede the constants apply to 
all of them. No blanks may occur within any of the subfields (unless provided 
as characters in a character constant or a character selfdefining term), nor 
may they occur between the subfields of an operand. 


The subfields of the DC operand are written in the following sequence: 


Subfield 


1 


Duplication Factor Constant(s) 


Although the constants specified within one operand must have the same 
characteristics, the individual operand may be completely different (e.g., 
PL1'01', A(SYMD). 


The symbol that names the DC instruction is the name of the constant (or 
first constant if the instruction specifies more than one). Relative 
addressing (e.g., SYMBOL*2) may be used to address the various constants 
if more than one has been specified, because the number of bytes allocated 
to each constant can be determined. 


The value attribute of the symbol naming the DC instruction is the address of 
the leftmost byte (after any necessary alignment) of the first, or only, 
constant. 


The length attribute depends on two things, the type of constant being 
defined and the presence of a length specification. Implied lengths are 
assumed for the various constant types in the absence of a length attribute. 
If more than one constant has been defined, the length attribute is the 
length in bytes (specified or implied) of the first constant. 
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C Boundary alignment also varies according to the type of constant being 
specified and the presence of a length specification. Some constant types 
are only aligned to a byte boundary, but the DS instruction can be used to 
force any type of word boundary alignment for them. This is explained under 
"DS-Define Storage". Other constants are aligned at various word boundaries 
half, full, or double) in the absence of a length specification. If length 
is specified, no boundary alignment occurs for such constants. 


Bytes that must be skipped in order to align the field at the proper 
boundary are not considered to be part of the constant. In other words, 

the Location Counter is incremented to reflect the proper boundary (if 

any incrementing is necessary) before the address value is established. Thus, 
the symbol naming the constant will not receive a value attribute that is 
the location of a skipped byte. 


Any bytes skipped in aligning statements that do not cause information to be 
assembled are not zeroed. Thus, bytes skipped to align a DC statement are 
zeroed, and bytes skipped to align a DS statement are not zeroed. 


Appendix А-1 summarizes, in chart form, the information concerning constants 
C discussed in this section. 


3.27.2 Operand Subfield 1: Duplication Factor 


The duplication factor may be omitted. If specified, it causes the constant (5) 
to be generated the number of times indicated by the factor. The factor may be 
specified either by unsigned decimal self-defining term or by a positive 
absolute expression that is enclosed in parentheses. The duplication factor 

is evaluated after the constant is assembled. All symbols in the expression 
must be previously defined. 


For DC constants the maximum value is 65535 (=2!5 --1). 


Note that a duplication factor of zero is permitted except in a literal 
and achieves the same result as it would in a DS instruction. See "Forcing 
Alignment" in section 3.29.2, "DS-Define Storage". 


- Note: 


If duplication is specified for an address constant containing a 
Location Counter reference, the value of the Location Counter used in each 
duplication is incremented bv the length of the operand. 


3.27.3 Operand Subfield 2: Type 


The type subfield defines the type of constant being specified. From the 
type specification, the assembler determines how it is to interpret the 
constant and translate it into the appropriate machine format. The type is 
specified by a single-letter code as shown in Figure 3-5. Note that this 
subfield may be omitted if the constant is a character type. 


Further information about these constants is provided in the discussion of 
the constants themselves under "Operand Subfield 4: Constant". 
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3.27.& Operand Subfield 3: Modifiers 


Modifiers describe the length in bytes desired for a constant (in contrast 
to an implied length), and the scaling and exponent for the constant. If 
multiple modifiers are written, they must appear in this sequence: length, 


scale, exponent. Each is written and used as described in the following text. 


Length Modifier: This is written as Ln, where n is either an unsigned 
decimal self-defining term or a positive absolute expression enclosed in 
parentheses. Any symbols in the expression must be previously defined. 


The value of n represents the number of bytes of storage that are reserved 
for the constant. The maximum value permitted for the length modifiers 

supplied for the various types of constants is summarized in Appendix А-1. 
This table also indicates the implied length for each type of constant; the 
implied length is used unless a length modifier may be specified for any 
type of constant. However, no boundary alignment will be provided when a 
length modifier is given. 


The Length must be greater than 0 (also for literals). 


Code Type of Constant 
C Character 

X Hexadecimal 

B Binary 

F Fixed-point 

H Fixed-point 

E Floating-point 

D Floating-point 

L Floating-point 

P Decimal 

Z Decimal 

A Address 

Y Address 

S Address 

V Address 

Q Address 

Table 3-5: Type Code For Constants 
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Machine Format 


8-bit code for each character 

4-bit code for each hexadecimal digit 
Binary format 

Signed, fixed-point binary format; 
normally a full word 

Signed, fixed-point binary format; 
normally a half word 

Short floating-point format; 

normally a full word 

Long floating-point format; 

normally a double word 

Extended floating point format; 
normally 2 double words 

Packed decimal format 

Zoned decimal format 

Value of address; normally a full word 
Value of address; normally a half word 
Base register and displacement value; 
a half word 

Space reserved for external symbol 
addresses; each address is normally 

a full word 


Space reserved for dummy register offset 


from the beginning of the dummy 
register vector 
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S Scale Modifier: This modifier is written as Sn, where n is either a 
decimal value or an absolute expression enclosed in parentheses. 


Anv symbol in the expression must be previously defined. The decimal 

value or the parenthesized expression may be preceded bv a sign; if none 
is present, a plus sign is assumed. The maximum values for scale modifiers 
are summarized in Appendix A-1. 


A scale modifier may only be used with fixed-point (F,H) and floating- 
point (E,D,L) constants. It is used to specify the amount of internal 
scaling that is desired, as follous. 


Scale Modifier for Fixed-Point Constants: The scale modifier specifies the 
power of two by which the constant must be multiplied after it has been 
converted to its binary representation. Just as multiplication of a decimal 
number by a power of 10 causes the decimal point to move, multiplication 
of a binary number by a power of two causes the binary point to move. This 
multiplication has the effect of moving the binary point away from its 
assumed position in the binary field; the assumed position being to the 
C right of the rightmost position. 


Thus, the scale modifier indicates either of the following: 


l. the number of binary positions to be occupied by the fractional portion 
of the binary number, or 


2. the number of binary positions to be deleted from the integral portion 
of the binary number. 


A positive scale of x shifts the integral portion of the number x binary 
positions to the left, thereby reserving the rightmost x binary positions 
for the fractional portion. A negative scale shifts the integral portion of 
the number right, thereby deleting rightmost integral positions. If a scale 
modifier does not accompany a fixed-point constant containing a fractional 
part, the fractional part is lost. 


In all cases where positions are lost because of scaling (or the lack of 
scaling), rounding occurs in the leftmost bit of the lost portion. The 
rounding is reflected in the rightmost position saved. 


C Scale Modifier for Floating-point Constants: Only a positive scale 

modifier may be used with a floating-point constant. It indicates the number 
of hexadecimal positions that the fraction is to be shifted to the right. 
Note that this shift amount is in terms of hexadecimal positions, each of 
which is four binary positions. (A positive scaling actually indicates that 
the point is to be moved to the left. However, a floating-point constant 
is aluays converted to a fraction, which is hexadecimally normalized. The 
point is assumed to be at the left of the leftmost position in the field. 
Since the point cannot be moved left, the fraction is shifted right). 


Thus, scaling that is specified for a floating-point constant provides an 
assembled fraction that is unnormalized, i.e., contains hexadecimal zeros 

in the leftmost positions of the fraction. When the fraction is shifted, the 
exponent is adjusted accordingly to retain the correct magnitude. When 
hexadecimal positions are lost, rounding occurs in the left most hexadecimal 
position of the lost portion. The rounding is reflected in the rightmost 
hexadecimal position saved. 
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Exponent Modifier: This modifier is written in the form En, where n is 
either a decimal self-defining term or an absolute expression enclosed in 
parentheses. Any symbols in the expression must be previously defined. The 
decimal value or the parenthesized expression may be preceded by a sign; if 
none is present, a plus sign is assumed. The maximum values for exponent 
modi fiers are summarized in Appendix A. 1. 


An exponent modifier may be used with fixed point (F,H) and floating-point 
(E, D, L) constants only. The modifier denotes the power of 10 by which the 
constant is to be multiplied before its conversion to the proper internal 
format. 


This modifier is not to be confused with the exponent of the constant itself, 
which is specified as part of the constant and is explained under "Operand 
Subfield 4: Constant". Both are denoted in the same fashion, as En. The 
exponent modifier affects each constant in the operand, whereas the exponent 
written as part of the constant, only pertains to that constant. Thus, a 
constant may be specified with an exponent of +2, and an exponent modifier of 
+5 may precede the constant. In effect, the constant has an exponent of +7. 


Note that there is a maximum value, both positive and negative, listed in 
Appendix A-1 for exponents. This applies to the exponent modifier and to the 
sum of the exponent modifier and the exponent specified as part of the 
constant. 


3.27.5 Operand Subfield 4: Constant 


This subfield supplies the constant (or constants) described by the 
subfields that precede it. A data constant (all types except A, Y, S, V and 
Q) is enclosed in apostrophes. 

An address constant (types A, Y, S, V and Q) is enclosed in parentheses. 

To specify two or more constants in the subfield, the constants must be 
separated by commas and the entire sequence of constants must be enclosed in 
the appropriate delimiters (i.e., apostrophes or parentheses). Thus, the 
format for specifying the constant(s) is one of the following: 


Single Constant Multiple Constants 

(not permitted for character constants.) 
"constant" constant, . „ constant“ 
(constant) (constant, . „ constant) 


All constant types except character (C), hexadecimal (X), binary (B), 

packed decimal (P), and zoned decimal (Z), are aligned on the proper 
boundary, as shown in Appendix A-1, unless a length modifier is specified. 

In the presence of a length modifier, no boundary alignment is performed. 

If the operand specifies more than one constant, any necessary alignment 
applies to the first constant only. Thus, for an operand that provides 

five full-word constants, the first would be aligned on a full-word boundary, 
and the rest would automatically fall on full-word boundaries. 


The total storage requirement of the operand is the product of the length 
times the number of constants in the operand times the duplication factor 
(if present) plus any bytes skipped for boundary alignment. If more than one 
operand is present, the storage requirement is derived by summing the 
requirements for each operand. 
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@ If an address constant contains a Location Counter reference, the Location 
Counter value that is used is the storage address of the first byte the 
constant will occupy. Thus, if several address constants in the same 
instruction refer to the Location Counter, the value of the Location 
Counter varies from constant to constant. Similarly if a single constant is 
specified (and it contains a Location Counter reference) with a duplication 
factor, the constant is duplicated with a varying Location Counter value. 


E and H constants are converted as if they were D and F, respectively, 
and then shortened. 


The subsequent text describes each of the constant types and provides 
examples. 


Character Constant-C: Any of the valid 256 punch combinations may be 
designated in a character constant. Only one character constant may be 
specified per operand. 


Special consideration must be given to representing apostrophes and 

C ampersands as characters. Each apostrophe or ampersand desired as a 
character in the constant must be represented by a pair of apostrophes or 
ampersands. Onlv one apostrophe or ampersand appears in storage. 


The maximum length modifier of a character constant is 256 bytes. No 
boundary alignment is performed. Each character is translated into one byte. 
Double apostrophes or double ampersands count as one character. If no length 
modifier is given, the size in bytes of the character constant is equal to 
the number of characters in the constant. If a length modifier is provided, 
the result varies as follows: 


1. If the number of characters in the constant exceeds the specified length, 
as many rightmost bytes as necessary are dropped. 


2. If the number of characters is less than the specified length, the excess 
rightmost bytes are filled with blanks. 


In the following example, the length attribute of FIELD is 12: 


ç FIELD C'TOTAL IS 110” 


However, in this next example, the length attribute is 15, and three blanks 
appear in storage to the right of the zero: 


Name Operation Operand 


FIELD DC CL15'TOTAL IS 110" 
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In the next example, the length attribute of FIELD is 12, although 13 J 
characters appear in the operand. The two ampersands count as only one byte. 


Name Operation Operand 


FIELD DC C'TOTAL IS &&10° 


Note that in the next example, a length of four has been specified, but there 
are five characters in the constant. 


Name Operation Operand 


FIELD DC JCL4' ABCDE" 


The generated constant would be: 
ABCDABCDABCD 3 


On the other hand, if the length had been specified as six instead of four, 
the generated constant would have been: 


ABCDE..ABCDE..ABCDE.. 


Note that the same constant could be specified as a literal. 


Name Operation Operand 


li 


C AREA( 12) , =3С1 6" ABCDE" 


Hexadecimal Constant-X: A hexadecimal constant consists of one or more 
of the hexadecimal digits, which are 0-9 and A-F. The maximum length 
modifier of a hexadecimal constant is 256 bytes (512 hexadecimal digits). 


Any word boundary alignment is only performed if a hexadecimal constant is 
used as a literal. The literal is aligned on half-word, full-word or double- 
word boundary if the explicit length is L2, L4, L8. 9 


Constants that contain an even number of hexadecimal digits are translated 
as one byte per pair of digits. If an odd number of digits is specified, 
the leftmost byte has the leftmost four bits filled with a hexadecimal zero, 
while the rightmost four bits contain the odd (first) digit. 
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çS If no length modifier is given, the implied length of the constant is half 
the number of hexadecimal digits in the constant (assuming that a 
hexadecimal zero is added to an odd number of digits). If a length modifier 
is given, the constant is handled as follows: 


1. If the number of hexadecimal digit pairs exceeds the specified length, the 
necessary leftmost bits (and/or bytes) are dropped. 


2. If the number of hexadecimal digit pairs is less than the specified 
length, the necessary bits (and/or bytes) are added to the left and filled 
with hexadecimal zeros. 


An eight-bit hexadecimal constant provides a convenient way of setting the 


bit pattern of a full binary word. The constant in the following example 
would set the first and third bytes of a word to 1's. 


Name Operation Operand 


TEST DS OF 
X*FF00FF00' 


о 
N 


The DS instruction sets the Location Counter to a full-word boundary. 


The next example uses a hexadecimal constant as a literal and inserts 115 
into low order of register 5. 


Name Operation Operand 


IC 5,-X'FF' INSERT CHAR. 


In the following example, the digit A would be dropped, because five 
hexadecimal digits are specified for a length of two bytes: 


Name Operation Operand 


ALPHA DC 3XL2' A6F4E* 


The resulting constant would be 6F4E, which would occupy the specified two 
bytes. It would then be repeated two more times, as requested by the 
duplication factor. If it had merely been specified as X'AGF4E', the 
resulting constant would have had a hexadecimal zero in the leftmost position: 
OAGFGE. 


In the following definition 


Name Operation Operand 


TEST DC XL4'01020304' 


the constant will not be aligned. Nor will the literal -X*'01020304'. 
The literal -XL4'01020304', however, will be aligned on word boundary. 
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Binary Constant-B: A binary constant is written using l's and 0's 
enclosed in apostrophes. Duplication and length may be specified. The 
maximum length modifier of a binary constant is 256 bytes. 


The implied length of a binary constant is the number of bytes occupied 
by the constant including any padding necessary. Padding or truncation takes 
place on the left. The padding bit used is a 0. 


The following example shows the coding used to designate a binary constant. 
BCON would have a length attribute of one. 


BCON DC B 11011101" 
BT RUNC DC BL1* 100100011" 
BPAD DC Βι 1.101" 


BTRUNC would assemble with the leftmost bit truncated, as follows: 00100011 


BPAD would assemble with five zeros as padding, as follows: 00000101 9 


Fixed-point Constants - F and H: 


A fixed-point constant is written as a decimal number, which may be followed 
by a decimal exponent if desired. The number may be an integer, a fraction, 
or a mixed number (i.e., one with integral and fractional portions). 

The format of the constant is as follous: 


1. The number is written as a signed or unsigned decimal value. The decimal 
point may be placed before, within, or after the number, or it may be 
omitted, in which case the number is assumed to be an integer. A positive 
sign is assumed if an unsigned number is specified. Unless a scale 
modifier accompanies a mixed number of fraction, the fractional portion 
is lost, as explained under SUBFIELD 3: Modifiers. 


2. The exponent is optional. If specified, it is written immediately after the 
number as En, where n is an optionally signed decimal value specifying the 
exponent of the factor 10. The exponent may be in the range -85 to +75. If 
an unsigned exponent is specified, a plus sign is assumed. The exponent 
causes the value of the constant to be adjusted by the specified power of Q 
10 before the constant is converted to its binary form. 


The exponent may be in the range -99 to +99, provided that the sum of the 
exponent and the exponent modifier do not exceed the permissible range for 
exponents. 


The number is converted to a binary number. The binary number is then 
rounded and assembled into the proper field, according to the specified 

or implied length. If the value of the number exceeds the length specified 
or implied, the sign is lost, the necessary leftmost bits are truncated to 
the length of the field and the value is then assembled into the whole field. 
Any duplication factor that is present is applied after the constant is 
assembled. A negative number is carried in 2's complement form. 
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C An implied length of four bytes is assumed for a full-word (F) and two 
bytes for a half-word (H), and the constant is aligned to the proper full-word 
or half-word boundary, if a length is not specified. However, any length up 
to and including eight bytes may be specified for either type of constant 
by a length modifier, in which case no boundary alignment occurs. 


Maximum and minimum values, exclusive of scaling, for fixed-point constants 
аге: 


A field of three full-words is generated from the statement shown below. 

The location attribute of CONWRD is the address of the left-most byte of the 
first word, and the length attribute is four, the implied length for a full- 
word fixed-point constant. The expression CONWRD+4 could be used to address 
the second constant (second word) in the field. 


Name Operation Operand 


The next statement causes the generation of a two-byte field containing a 
negative constant. Notice that scaling has been specified in order to reserve 
six bits for the fractional portion of the constant. 


C HALFCON DC HS6' -25. 46" 


The next constant (3.50) is multiplied bv 10 to the -2 before being converted 
to its binary format. The scale modifier reserves twelve bits for the 
fractional portion. 


FULLCON DC HS12' 3. 5O0E-2"' 


The same constant could be specified as a literal: 


7 ,-HS12' 3. 50E-2“ 
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The final example specifies three constants. Notice that the scale modifier 2 
requests four bits for the fractional portion of each constant. The four bits 
are provided whether or not the fraction exists. 


Name Operation Operand 


THREECON FS4* 10,25. 3, 1007 


Floating-point Constants (E,D,L): A floating-point constant is written as 
a decimal number, which may be followed by a decimal exponent, if desired. 
The number may be an integer, a fraction, or a mixed number (i.e., one with 
integral and fractional portions). The format of the constant is as follows? 


1. The number is written as a signed or unsigned decimal value. The decimal 
point may be placed before, within, or after the number, or it may be 
omitted, in which case the number is assumed to be an integer. A positive 
sign is assumed if an unsigned number is specified. 


2. The exponent is optional. If specified, it is written immediately after ә 
the number as En, where n is an optionally signed decimal value specifying 
the exponent of the factor 10. The exponent may be in the range -99 to 
*99, provided that the sum of the exponent and the exponent modifier does 
not exceed the permissible range for exponents and the value of the 
expression is within the range of the representable numbers (see Appendix 
A.2 for the relevant estimates). If an unsigned exponent is speci fied, 
a plus sign is assumed. 


Machine format for a floating-point number is in two parts: The portion 
containing the exponent, which is sometimes called the characteristic, 
followed by the portion containing the fraction, which is sometimes called 
the mantissa. Therefore, the number specified as a floating-point constant 
must be converted to a fraction before it can be translated into the proper 
format. For example, the constant 27.35E2 represents the number 27.35 x 10727. 
Represented as a fraction, it would be 0.2735 ж 107417, the exponent having 
been modified to reflect the shifting of the decimal point. The exponent may 
also be affected by the presence of an exponent modifier, as explained under 
Operand Subfield 3: Modifiers. 


The exponent is then translated into its binary equivalent, and the fraction 
is converted to a binary number. Scaling (see Appendix A.l: Range for Scale) 9 
is performed if specified; if not the fraction is normalized (leading 

hexadecimal zeros are removed). Rounding of the fraction is then performed 

according to the specified or implied length, and the number is assembled 

into the proper field. Hithin the portion of the floating-point field 

allocated to the fraction, the hexadecimal point is assumed to be the left 

of the leftmost hexadecimal digit, and the fraction occupies the leftmost 

portion of the field. Negative fractions are carried in true representation, 

not in the 25 complement form. 
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The lengths implied for full-word (E), double-word (D), and extended (L) 
constants are four, eight, and 16 bytes, respectively. The location 

counter is aligned at full-word (E) or double-word (D,L) boundary if a length 
is not specified. However, any length up to and including 8 bytes may be 
specified for constant types D,E by a length modifier; up to and including 

16 bytes, for L-constants. 


But no boundary alignment occurs in that case. 


Any of the following statements could be used to specify 46.415 as a positive, 
full-word, floating-point constant; the last is a machine instruction 
statement with a literal operand. Note that the last two constants contain 

an exponent modifier. 


DC E'46.415' 

DC E“ 464 15E-3* 
DC E“ 4464. 15E-1" 
DC E“ T. 46415E T2“ 
DC EE Z“. 464 15 
AE 


6, EE2Z“. 464157 


The following would each be generated as double-word floating-point constants. 


Name Operation Operand 


FLOAT DC DE+&*+&6,-3.729,+673" 


The following constants are each generated as floating-point constants in 
2 double words: 


Name Operation Operand 


EXTEND DC LE3'48,-2.71' 


Decimal Constants-P and Z: A decimal constant is written as a signed or 
unsigned decimal value. If the sign is omitted, a plus sign is assumed. 
The decimal point may be written wherever desired or may be omitted. 
Scaling and exponent modifiers may not be specified for decimal constants. 
The maximum length of decimal constant is 16 bytes. No word boundary 
alignment is performed. The position of a decimal point in the definition 
does not affect the assembly of the constant in any way, because, unlike 
fixed-point and floating-point constants, a decimal constant is not 
converted to its binary equivalent. The fact that a decimal constant is an 
integer, a fraction, or a mixed number is not pertinent to its generation. 
Furthermore, the decimal point is not assembled into the constant. The 
programmer may determine proper decimal point alignment either by defining 
his data so that the point is aligned or by selecting machine instructions 
that will operate on the data properly (i.e., shift it for purposes of 
alignment). 
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The Location Counter is aligned only if a decimal constant is used as a 9 
literal. The literal is aligned on half-word, full-word or double-word 
boundary if the length is L2, L4, L8. 


If zoned decimal format is specified (Z), each decimal digit is translated 
into one byte. The translation is done according to the character set shown 
in Appendix A-3. The rightmost byte contains the sign as well as the 
rightmost digit. For packed decimal format (P), each pair of decimal digits 
is translated into one byte. The rightmost digit and the sign are 
translated into the rightmost byte. The bit configuration for the digits is 
identical to the configurations for the hexadecimal digits 0-9 as explained 
under "Hexadecimal Self-Defining Value". For both packed and zoned decimals, 
a plus sign is translated into the hexadecimal digit C, and a minus sign 
into the digit D. 


If an even number of packed decimal digits is specified, one digit will be 
left unpaired, because the rightmost digit is paired with the sign. 
Therefore, in the leftmost byte, the leftmost four bits will be set to zeros 
and the rightmost four bits will contain the odd (first) digit. 


If no length modifier is given, the implied length for either constants is 
the number of bytes the constant occupies (taking into account the format j э 
sign, and possible addition of zero bits for packed decimals). If a length 

modifier is given, the constant is handled as follous: 


1. If the constant requires fewer bvtes than the length specifies, the 
necessary number of bytes is added to the left. For zoned decimal format, 
the decimal digit zero is placed in each added byte. For packed decimals, 
the bits of each added bvte are set to zero. 


2. If the constant requires more bvtes than the length specifies, the 
necessary number of leftmost digits or pairs of digits is dropped, 
depending on which format is specified. 


Examples of decimal constants definition: 


DC P'+1, 25" 

DC Z' -5643' 

DC 2'79.68* : 

DC PL3'79.68"' 9 
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C The following statement specifies three packed decimal constants. The length 
modifier applies to each packed decimal constant. 


Name Operation Operand 


DECIMALS | DC PL8'*25.8,-3874,*2. 3" 


The last example illustrates the use of a packed decimal literal. 


QUTAREA, =PL2*+25" 


© 3.27.6 Address Constants 


An address constant is a virtual storage address or an absolute expression 
that is translated into a constant. Address constants are normally used for 
initializing base registers to facilitate the addressing of storage. 
Furthermore, they provide the means of communicating between control 
sections of a multi-section program. However, storage addressing and control 
section communication are also dependent on the use of the USING assembly 
instruction and the loading of registers. Coding examples that illustrate 
these considerations are contained in the discussion of "Programming with 
the USING instruction" (section 3.12.2). 


An address constant, unlike other types of constants, is enclosed in 
parentheses. If two or more address constants are specified in a statement, 
they are separated by commas, and the entire sequence enclosed in 
parentheses. There are five types of address constants: A, Y, S, V and Q. 


Complex Relocatable Expressions: Α complex relocatable expression can only 
be used in an A-type or Y-type address constant. These expressions contain 
two or more unpaired relocatable terms and/or a negative relocatable term 
© in addition to апу absolute ог paired relocatable terms that may be present. 

A complex relocatable expression might consist of external symbols (which 
cannot be paired) and designate an address in an independent assembly that is 
to be linked and loaded with the assembly containing the complex relocatable 
expression. 


The value of the expression is determined when the referenced control sections 


are loaded. Complex relocatable expressions can be used to determine the 
distance between two control sections after they are loaded into main storage. 
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A-type Address Constant: This constant is specified as an absolute, 9 
relocatable, or complex relocatable expression. (Remember that an expression : 
may be single term or multiterm.) The value of the expression is calculated 
to 32 bits with one exception: the maximum value of the expression may be 
2??-]. The value is then truncated on the left, if necessary, to the specified 
or implied length of the field and assembled into the rightmost bits of the 
field. The implied length of an A-type constant is four bytes and alignment 
is to a full-word boundary unless a length is specified, in which case no 
alignment will occur. A length of 1-4 bytes may be specified. The programmer 
must remember that the value of relocatable A-constants may be truncated if 
fewer than 4 bytes are used as the length modifier. 


In the following examples, the field generated from the statement named 
ACONST contains four constants, each of which occupies four bytes. Note 
that there is a Location Counter reference in one. | 


The value of the Location Counter will be the address of the first byte 
allocated to the fourth constant. The second statement shows the same set of 
constants specified as literals (i.e., address constant literals). 


ACONST DC A( 108, LOOP, END-STRT ,x44096) 
LM 4, 7, 0108, LOOP, END-STRT , +4096) 
Note: 


When the Location Counter reference occurs in a literal, as in the LM 
instruction above, the value of the Location Counter is the address of 
the first byte of the instruction. 


Y-type Address Constant: A Y-type address constant has much in common 

with the A-type constant. It, too, is specified as an absolute, relocatable, 
or complex relocatable expression. The value of the expression is also 
calculated to 32 bits. However, the maximum value of the expression 

may be only 20-1. The value is then truncated, if necessary, to the 
specified or implied length of the field and assembled into the rightmost 
bits of the field. The implied length of a Y-type constant is two bytes and 
alignment is to a half-word boundary unless a length is specified, in which 
case no alignment occurs. The maximum length of a Y-type address constant is 

two bytes. 2 
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S-type Address Constant: The S-type address constant is used to store an 
address in base-displacement form. 
The constant may be specified in two ways? 


l. As an absolute or relocatable expression, e.g., S(BETA) 


2. As two absolute expressions, the first of which represents the displacement 


value and the second, the base register, e.g., S(400(13)). 


The address value represented by the expression in (1) will be broken down 
by the assembler into the proper base register and displacement value. 

An S-type constant is assembled as a halfword and aligned on a halfword 
boundary. The leftmost four bits of the assembled constant represent the base 
register designation, the remaining 12 bits the displacement value. 


If length specification is used, only two bytes may be specified. 
S-type address constants may not be specified as literals. 


V-type Address Constant: This constant is used to reserve storage for the 
address of an external symbol that is used for effecting branches to other 
programs. The constant may not be used for external data references. The 
constant is specified as one relocatable symbol, which must not be identified 
by an EXTRN statement. The symbol used is assumed to be an external symbol 

by virtue of the fact that it is supplied in a V-type constant. 


Note that specifying a symbol as the operand of a V-type constant does 

not constitute a definition of the symbol for this assembly. The implied 
length of a V-type address constant is four bytes, and boundary alignment is 
to a full word. A length modifier may be used to specify a length of either 
three or four bytes, in which case no such boundary alignment occurs, and 
truncation of the relocated value may result. In the following example, 12 
bytes will be reserved, because there are three symbols. The value of each 
assembled constant will be zero until the program is loaded. 


Name Operation Operand 


VCONST DC VCSORT,MERGE, CALC) 
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3.28 


Q-type Address Constant: The Q-type Address Constant is used to reserve 
storage space for the offset of a dummy register, which must previously 
have been defined as a DXD or DSECT. If it has been defined as a DSECT, this 
DSECT is taken as a dummy register in relation to the external information. 
The implied length of a Q-type constant is four bytes. Length specifications 
of 1 to 4 are legal. 


In the following example, D1 and D2 have previously been defined as DXD or 
DSECT. 8 bytes are reserved for the Q-type constants by means of two symbols. 


The value of the constants, i.e. the offset of the dummy registers from the 
beginning of the dummy register vector, is entered by the Linkage Editor. 


QCONST DC Q(D1,D2) 


Example: 
DC QCDXDEXT) 


LITERAL DEFINITIONS 


The reader is reminded that the discussion of literals as machine instruction 
operands referred him to the description of the DC operand for the method 

of writing a literal operand. All subsequent operand specifications are 
applicable to writing literals, the only differences being: 

1. The literal is preceded by an = sign. 

2. The duplication factor may not be zero. 

3. S-type address constants may not be specified. 


4. Multiple operands may not be specified. 


Examples of literals appear throughout the balance of the DC instruction 
discussion. 
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çS 3.29 DS INSTRUCTION 


3.29.1 DS - Define Storage 


The DS instruction is used to reserve areas of storage and to assign names 
to those areas. The use of this instruction is the preferred way of 
symbolically defining storage for work areas, input/output areas, etc. 


The typical form of the DS statement is: 


A symbol One or more operands in the format described in 
or blank the following text, each separated by commas. 


ç The format of the DS operand is identical to that of the DC operand, exactly 
the same subfields are employed, written in exactly the same sequence as they 
are in the DC operand. Although the formats are identical, there are two 
differences in the specification of subfields. They are: 


l. The specification of data (subfield 4) is optional in a DS operand, 
but it is mandatory in a DC operand. If a constant is specified, it must 
be valid. 


2. The maximum length that may be specified for character (C) and hexadecimal 
(0 field types is 65,535 bytes rather than 256 bytes. 


3. The maximum duplication factor for DS constants is 16777215 (Ξ 224-1), 


If а DS орегапа specifies а constant іп subfield &, and no length is specified 
in subfield 3, the assembler determines the length of the data and reserves 
the appropriate amount of storage. It does not assemble the constant. 
It is convenient for the programmer to be able to specifv data and have the 
assembler calculate the storage area that would be required for such data. 
If he knows the general format of the data that will be placed in the 

© storage area during program execution, all he needs to do is specify it in 
the fourth subfield in a DS operand. The assembler then determines the 
correct amount of storage to be reserved, thus relieving the programmer of 
the need to specify length. 


If the DS instruction is named by a symbol, its value attribute is the 
location of the leftmost byte of the reserved area. The length attribute of 
the symbol is determined in the same manner as for a DC. Any positioning 
required for aligning the storage area to the proper type of boundary is 
done before the address value is determined. Bytes skipped for alignment are 
not set to zero. 
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Each field type (e.g., hexadecimal, character, floating-point) is associated ә 
with certain characteristics (these are summarized in Appendix A.1). The 
associated characteristics will determine which field-type code the programmer 
selects for the DS operand and what other information he adds, notably a 
length specification or a duplication factor. For example, the E floating- 
point field and the F fixed-point field both have an implied length of four 
bytes. The leftmost byte is aligned to a full-word boundary. Thus, either 

code could be specified if it were desired to reserve four bytes of storage 
aligned to a full-word boundary. To obtain a length of eight bytes, one 

could specify either the E or F field type with a length modifier of eight. 
However, a duplication factor would have to be used to reserve a larger area, 
because the maximum length specification for either type is eight bytes. 

Note also that specifying length would cancel any special boundary alignment. 


In contrast, packed and zoned decimal (P and Z), character (C), hexadecimal 
(X), and binary (B) fields have an implied length of one byte. Any of these 
codes, if used, would have to be accompanied by a length modifier, unless 
just one byte is to be reserved. Although no alignment occurs, the use of C 
and X field types permits greater latitude in length specifications. 


Unless a field of one byte is desired, either the length must be specified J 
for the C, X, P, Z, or B field types, or else the data must be speci fied 
(as the fourth subfield), so that the assembler can calculate the length. 


To define four 10-byte fields and one 100-byte field, the respective DS 
statements might be as follows: 


FIELD 4CL10 
AREA CL100 


Although FIELD might have been specified as one 40-byte field, the preceding 
definition has the advantage of providing FIELD with a length attribute of 10. 
This would be pertinent when using FIELD as an SS machine instruction operand. 


Additional examples of DS statements are shown below! 


ONE DS CL80 (one 80-byte field, length attribute of 80) 
TWO DS 80C (80 one-byte fields, length attribute of 1) 
THREE DS 6F (Six full words, length attribute of four) 
FOUR DS D (one double word, length attribute of eight) 
FIVE DS 4H (four half-words, length attribute of two) 
Note: 


A DS statement causes the storage area to be reserved but not set to zeros. 
No assumption should be made as to the contents of the reserved area. 
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C 3.29.2 Special Uses of the Duplication Factor 


Forcing Alignment: The Location Counter can be forced to a double-word, 
full-word, or half-word boundary by using the appropriate field type (e.g., 
D, F, or H) with a duplication factor of zero. This method may be used to 
obtain boundary alignment that otherwise would not be provided. For example, 
the following statements would set the Location Counter to the next double- 
word boundary and then reserve storage space for a 128-byte field (whose 
leftmost byte would be on a double-word boundary). 


OD 
AREA CL128 


Defining Fields of an Area: A DS instruction with a duplication factor 

of zero can be used to assign a name to an area of storage without actually 
© reserving the area. Additional DS and/or DC instructions may then be used to 

reserve the area and assign names to fields within the area (and generate 

constants if DC is used). 


For example, assume that 80-character records are to be read into an area 
for processing and that each record has the following format: 


Positions 5 - 10 Payroll Number 
Positions 11 - 30 Employee Name 
Positions 31 - 36 Date 

Positions 47 - 54 Gross Wages 
Positions 55 - 62 Mithholding Tax 


The following example illustrates how DS instructions might be used to 

assign a name to the record area, then define the fields of the area and 

allocate the storage for them. Note that the first statement names the 

entire area by defining the symbol RDAREA: the statement gives RDAREA a 

length attribute of 80 bytes, but does not reserve any storage. Similarly, 

the fifth statement names a 6-byte area by defining the symbol DATE: the 

three subsequent statements actually define the fields of DATE and allocate 

storage for them. The second, ninth, and last statements are used for spacing 
© purposes and, therefore, are not named. 


RDAREA 0CL80 
CL4 
PAYNO CL6 
NAME CL20 
DATE 0CL6 
DAY CL2 
MONTH CL2 
YEAR CL2 
CL10 
GROSS CL8 
FEDTAX CL8 
CL 18 
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3.30 DUMMY REGISTERS 


Dummy registers are memory areas supporting the communication between 
various control sections. They can be defined anywhere in the program, 
i.e., the dummy register definitions need not be written consecutively. It 
is also possible to define one and the same dummy register, with differing 
lengths, in more than one assembly unit (see PSREG2 in Example 1). 


The assembler calculates alignment and length of the dummy register and 
passes this information, via ESD entries, on to the Linkage Editor. During 
linkage editing, all dummy registers from all modules to be linked are 
combined to form one so-called "dummy register vector", i.e., the dummy 
registers all appear in the linked program in a specific consecutive order, 
defined by the Linkage Editor. Hence the suffix "vector". During linkage 
editing, the strongest attributes for identical dummy registers are used as 
the ultimately valid attributes for this dummy register. In Example 1 (see 
Appendix Α. 11), PSREG2 in CSECT 1 has a length of 60 bytes; in CSECT2, 

a length of 22 bytes. So after linkage editing, the dummy register 

PSREG2 has a length of 60 bytes. Exactly the same conditions prevail as far 
as alignment is concerned: if a dummy register had been aligned on hal fword 
boundary in one CSECT, but on fullword boundary in another, this dummy 
register would have been aligned on fullword boundary after linking. 


The maximum length of a dummy register is 4095 bytes. 


The use of dummy registers has the following advantage over the application 
of common areas: 


Assume CSECT1 with PSREG1 and PSREG2 
CSECT2 with PSREG3 and PSREG4 


Both CSECTS are to be linked into one program. 


Within a CSECT it is only possible to access dummy registers which have 
been defined in this very СЅЕСТ. So in CSECT1, only PSREG1 and PSREG2. 
Intentional or inadvertent overwriting of PSREG3 and PSREG4 is impossible. 


If the number of dummy registers is changed within a module, this module 
only will have to be reassembled and the entire program relinked. However, 
if you change the DSECT of a common area, then all modules affected by a 
change of contents or length of the common area have to be reassembled. 


Note 


Currently, the DLL does not support the use of dummy registers, i.e., 
programs must be linked with TSOSLNK and no dynamic loading mechanism 
can be used. 


3-82 Assembler V29.1C, U62-J-255-6-7600 


Dummy registers 


C Dummy registers can be addressed in two ways? 
— Via Q-type constants 


At program run-time the Q-type constant indicates the dummy register 
offset from the beginning of the dummy register vector. This means that 
this value must be added to the start address of the dummy register 
vector in order to address the dummy register. 


— Via a base register 
The instruction 
USING xPRV,R8 
causes all instructions concerning dummy registers to use register 8 as 
the base register, irrespective of any other valid base registers. 


Register 8 must then be loaded with the start address of the dummy 
register vector. 


@ 3.30.1 Define Dummy Registers (DSECT, DXD) 
A dummy register can be defined in two ways: 


e As a DSECT, the name of the DSECT then being used as the operand of a 
Q-type constant. 


NAMED DSECT Not used 
QNAMED DC QCNAMED) 


e Via the assembler instruction DXD 


© Format of the DXD instruction 


Name Operation Operand 


NAME DXD Same operand as described for DS 


For examples see Appendix A.11 
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3.30.2 Define Length of Dummy Register Vector (CXD) 9 


The CXD instruction reserves a word (four bytes) in which the Linkage 
Editor enters the total length of the dummy register vector. 

The length of the dummy register vector is important for later processing, 
e.g., for allocation of the necessary memory space. 


Format of the CXD instruction 


NAME CXD Blank 
or 
blank 


The CXD instruction must be aligned on fullword boundaries and may occur 
anywhere in the program. The length attribute is four. The type attribute 


is A (see 4.15.1). э 


For ап example see Appendix A.11 (Example 2). 
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ç 3.31 LISTING CONTROL INSTRUCTIONS 


The listing control instructions are used to identify an assembly listing 

and assembly output cards, to provide blank lines in an assembly listing, 

and to designate how much detail is to be included in an assembly listing. 
No instructions or constants are generated for the object program. Listing 
control statements except PRINT are never printed. The line count per page 
can be controlled using the LINECNT parameter. 


3.31.1 TITLE - Identify Assembly Output 


The TITLE assembly instruction enables the programmer to identify assembly 
listing and assembly output cards. 


The TITLE instruction statement has the following format: 


Name, TITLE One to 97 characters, enclosed in single 
sequence apostrophes 

symbol, 

or blank 


The name entry may contain a name of from one to four alphabetic or 
numeric characters in any combination. The contents of the name entry are 
output in columns 73-76 of the object module except those produced by the 
PUNCH and REPRO assembly instructions. Only the first TITLE statement 

in a program may have a name in the name entry. The name field of all 
subsequent TITLE statements must be blank. 


The operand field may contain up to 97 characters enclosed in apostrophes. 

Any ampersands or apostrophes enclösed within the surrounding apostrophes 

must be represented by two ampersands or apostrophes. However, only one 

ampersand or apostrophe is printed and counted in the total number of 

operand character. The contents of the operand field are printed at the 
C | top of each page of the assembly listing. 


A program may contain more than one TITLE statement. Each TITLE statement 
provides the heading for pages in the heading for pages in the assembly 
listing that follow it, until another TITLE statement is encountered. Each 
TITLE statement encountered after the first one causes the listing to be 
advanced to a new page (before the heading is printed). 

For example, if the following statement is the first TITLE statement to 
appear in a program: 


Name Operation Operand 


PGM1 TITLE "FIRST HEADING" 


then PGM1 is punched into all of the output cards (columns 73-76) and this 
heading appears at the top of each page: FIRST HEADING. 
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If the following statement occurs later in the same program: 2 


TITLE ΣΑ NEW HEADING' 


then, PGM1 is still output in the output cards, but each following page 
begins with the heading: Α NEN HEADING. 


The sequence number of the cards in the output deck is contained in columns 
77-80, except those produced by the PUNCH and REPRO assembly instructions. 


Note: 
If a TITLE statement is generated by means of a macro, it is also 
effective if the listing is deactivated by means of PRINT NOGEN. In this 


case it can be rendered ineffective by means of xCOMOPT NOPRTIT 
(page feed, print header line). 


3.31.2 EJECT - Start New Page 


The EJECT assembly instruction causes the next line of the listing to appear 
at the top of a new page. This instruction provides a convenient way of 
separating routines in the program listing. 


The EJECT Instruction statement has the following formats: 


Sequence | EJECT Not used; should be blank. 

symbol 

or blank 

If the next line of the listing would appear at the top of a new page 9 
without the EJECT instruction, the EJECT instruction has no immediate effect. 


Two EJECTSs in succession cause a page to be skipped. A TITLE statement 
followed immediately by an EJECT statement will result in a page with a title 
line and a statement heading line. Text following the EJECT instruction 

will begin at the top of the next page. 
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© 3.31.3 SPACE - Space Listing 
The SPACE assembly instruction is used to insert one or more blank lines 
in the listing. 


The SPACE instruction statement has the following format: 


Sequence SPACE A decimal value or blank 
symbo1 
or blank 


A decimal value is used to specifv the number of blank lines to be inserted in 
the assemblv listing. A blank operand causes one blank line to be inserted. 

If this value exceeds the number of lines remaining on the listing page, 

the statement will have the same effect as an EJECT statement. 


3.31.4 PRINT - Print Optional Data 


The PRINT assembly instruction controls the content of the assembly listing. 


The PRINT instruction has the following format: 


Sequence PRINT One to twelve operands 
symbol 
or blank 


One to twelve operands of the following form may be used: 


BASE After every USING and DROP statement, the particular 
addressable area for registers employed as base registers with 
USING is printed. 


NOBASE No areas for the base registers are printed. 

CLOSED - The cross-reference listing is single-spaced. 

OPEN - The cross-reference listing is double-spaced. 

CODE - The effect of PRINT NOGEN on statements generated by macro 
instructions is restricted. Only the code generated 
is output, the source line being suppressed. 

NOCODE - The full effect of PRINT NOGEN is retained. 

COPY Copied statements are listed. 

NOCUPY Copied statements are not listed. 
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DECK 
or 
NODECK 


SEN 
or 
NOGEN 


SINGLE 


or 
DOUBLE 


- Constants are printed out in full in the listing. 


- Only the leftmost eight bytes (16 hexadecimal digits) are 
printed. 


- The object code is generated. 

- Generation of the object code is interrupted. 

- All statements generated by macro instructions are printed. 

- Statements generated by macro instructions are not printed, 
except MNOTE messages which print regardless of NOGEN. 
However, the outer macro instruction itself will appear 
in the listing. 


- The normal assembly listing headings are generated. 


- Headings for TRANSDATA 960 (DUET) instructions are generated. 
The DUET instructions are represented by bits. 


- Print the card number of the various object program card 
types. 


- Inhibit printing the card number of the various card types. 

- A listing is printed. 

- No listing is printed. 

- Symbols beginning with the character x are included in the 
cross-reference listing. Up to 5 different entries are 


allowed. 


- Symbols beginning with the character x are not included in 
the cross-reference listing. ; 


- All symbols are included in the cross-reference listing. 


- Only the referenced symbols are included in the cross- 
reference listing. 


Note: The PRINT Statement operands for the cross-reference 
listing only cause the last statements to be executed. 


- Text listing is single spaced. 


- Text listing is double spaced. 


A program may contain any number of PRINT statements. The conditions set by 
a PRINT statement are in effect until another PRINT statement is encountered. 


If an operand is omitted, it is assumed to be unchanged and continuous 
according to its last specification. 


When OFF is specified, GEN and DATA have no effect. When NOGEN is speci fied, 
DATA has no effect for generated constants. 
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Listing control 
ç | Until the first ΡΕΙΝΤ statement is encountered, the following is assumed: 


Name Operation Operand 


PRINT ON,NODATA , GEN 


For example, if the statement: 


Name Operation Operand 


DC ΧΙ 256" 00" 


appears in a program, 256 bytes of zeros are assembled. 
C If the statement: 


Name Operation Operand 


PRINT DATA 


is the last PRINT statement to appear before the DC statement, all 
256 bytes of zeros are printed in the assembly listing. However, if there 
are no previous PRINT statements, or: 


Name Operation Operand 


PRINT NODATA 


is the last PRINT statement to appear before the DC statement, only eight 
bytes of zeros are printed in the assembly listing. 


Assembler V29.1C, U62-J-255-6-7600 3-89 


1/0 Control 


3-32 PROGRAM CONTROL INSTRUCTIONS 


The program control instructions are used: 

— to specify the end of an assembly, 

— to set the Location Counter to a value or half-word boundary, 
— to insert previously written coding in the program, 

— to specify the position of literals in storage, 

= to check the sequence of input cards, 

— to indicate statement format, 

— to output cards to the object module. 


Except for the CNOP instruction, none of these assembly instructions 
generate instructions or constants in the object program. 


3.32.1 ICTL - Input Format Control 


The ICTL instruction allows the programmer to alter the normal format of his 
source program statements. The ICTL statement must precede all other 
statements in the source program and may be used only once. 


The ICTL instruction statement has the following format: 


not ICTL 1-3 decimal values of the form b,e,c 
used 


Operand b specifies the begin column of the source statement. It must always 
be specified, and must be from 1-40, inclusive. Operand e specifies the end 
column of the source statement. The end column, when specified, must be from 
41-79, inclusive; when not specified, it is assumed to be 71. The column after 
the end column is used to indicate whether the next card is a continuation 
card. Operand c specifies the continue column of the source statement. The 
continue column, when specified, must be from 2-40 and must be greater than 

or equal to the value of b. If the continue column is not specified, the 
assembler assumes that there are no continuation cards. 


The next example designates the begin column as column 25. Since the end 
column is not specified, it is assumed to be column 71. No continuation 
cards are recognized because the continue column is not specified. 


Name Operation Operand 


ICTL 25 
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@ 3.32.2 ISEQ - Input Sequence Checking 


The ISEQ instruction is used to check the sequence of input cards. 


The ISEQ instruction has the following format: 


Sequence Two decimal values of the form 1,r, or not used 
symbol 
or blank 


The operands 1 and r, respectively, specify the leftmost and rightmost 
columns of the field in the input cards to be checked. Operand r must be 
equal to or greater than operand 1. Columns to be checked must not be 
between the "begin" and "end" column. 


The field to be checked must not exceed 8 bytes. Sequence checking begins 

© with the first card following the ISEQ statement. Comparison of adjacent 
cards makes use of the eight-bit internal collating sequence. Each card 
checked must be higher than the preceding one. 


An ISEQ statement with a blank operand terminates the operation. Checking 
may be resumed with another ISEQ statement. 


Sequence checking is only performed on statements contained in the source 
program. Statements generated by a macro instruction are not checked for 
sequence. 


3.32.3 PUNCH — Output in Card Format 


The PUNCH assembly instruction causes the data in the operand to be output 
in card format to the object module. Each PUNCH statement produces a card. 
As many PUNCH statements may be used as are necessary. 


S The PUNCH instruction has the following format: 
Sequence PUNCH 1 to 80 characters enclosed in apostrophes 
symbol 
or blank 


The operand is a self-defining term of up to 80 characters. All characters, 
including blank, are valid. The position immediately to the right of the 
left apostrophe is mapped in column one of the card. The assembly program 
does not process the data other than causing it to be stored in card 
format. For each apostrophe to be mapped on the card and for each 
&-character, two apostrophes or &-characters must be specified in the 
operand. The two apostrophes or &-characters are reduced to a single 
apostrophe or &-character and count as only one character in the operand. 
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PUNCH statements may occur anywhere within a program or macro definition. If 
a PUNCH statement occurs before the first control section, the resultant card 
will precede all other cards in the object module; otherwise the card will 

be punched in place. No sequence number or identification is output to the 
card. 


Note: 


Unlike the BS2000 command PUNCH (see 2.7.4) this statement does not 
cause cards to be punched. 


3.32.4 REPRO — Reproduce Following Card 


The REPRO assembly instruction causes data on the following statement line 

to be output to the object module. The data is not processed; no substitution 
is performed for variable symbols. No sequence number or identification is 
output to the card. One REPRO instruction produces one card. 


REPRO statements that occur before all statements composing the first or only 
control section will produce cards which precede all cards of the object 
program in the object module. 


The REPRO instruction has the following format: 


Sequence | REPRO Not used, should not be present 
symbol 
or blank 


The line to be reproduced may contain any combination of up to 80 characters. 
Characters may be entered starting in column 1 and continue through column 80 
of the line. Column 1 of the line is mapped in column 1 of the card. 


3.32.5 ORG ~ Set Location Counter 


3-92 


The ORG instruction is used to alter the setting of the Location Counter for 
the current control section. 


The ORG instruction has the following format: 


A symbolic An expression or blank 
address, a 

sequence sym- 

bol or blank 
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S Any symbols in the expression must have been previously defined. Any unpaired 
relocatable symbols must be defined in the same control section in which 
the ORG statement appears. The expression must be relocatable and must not 
be complex. Absolute expressions are invalid. 


The Location Counter is set to the value of the expression in the operands. 
If the operand is omitted, the Location Counter is set to a location that is 
one byte higher than the maximum location assigned for the control section 
up to this point. 


An ORG statement must not be used to specify a location below the beginning 
of the control section in which it appears. For example, the statement: 


Name Operation Operand 


x-500 


is invalid if it appears less than 500 bytes from the beginning of the current 
Ç control section. 


If the Location Counter is to be reset to the next available location in the 
current control section, the following statement would be used: 


If previous ORG statements have reduced the Location Counter for the purpose 
of redefining a portion of the current control section, an ORG statement with 
an omitted operand can then be used to terminate the effects of such 
statements and restore the Location Counter to its highest setting. 


A symbol in the name field of an ORG statement receives the address before 


execution of this statement. This provides the possibility to refer 
symbolically to the Location Counter before execution of the ORG statement. 


Example: 


NEWADDR CL100 
OLDADDR NEWADDR 
OLDADDR 
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3.32.6 LTORG — Begin Literal Pool 


3-96 


The LTORG assembly instruction causes all literals since the previous LTORG 
or beginning of the program to be assembled at appropriate boundaries 
starting at the first double-word boundary following the LTORG statement. 

If no literals follow the LTORG statement, alignment of the next instruction 
will occur. Bytes skipped are not zeroed. The maximum number of permitted 
LTORG statements is 255. 


The literals are aligned as strongly as possible corresponding to their type 
and length. For example, the literals CL4'1234' and =C*1234" are both filed 

at word boundaries. An exception to this are the constants B, X, P, Z with 
implicit lengths, since in these cases a literal can contain several constants 
of different length. 


The LTORG instruction has the following format: 


A symbol, LTORG Not used, should not be present 
sequence 

symbol, or 

blank 


The symbols represents the address of the first byte of the literal pool. 
It has a length attribute of one. 


Special Addressing Considerations 


Any literals used after the last LTORG statement in a program are placed at 
the end of the first control section. If there are no LTORG statements in a 
program, all literals used in the program are placed at the end of the first 
control section. In these circumstances the programmer must ensure that the 
first control section is always addressable. This means that the base address 
register for the first control section should not be changed through usage 

in subsequent control sections. If the programmer does not wish to reserve a 
register for this purpose, he may place a LTORG statement at the end of each 
control section, thereby ensuring that all literals appearing in that section 
are addressable. 


If duplicate literals occur within the range controlled by one LTORG 
statement, only one literal is stored. Literals are considered duplicates 
only if their specifications are identical. A unique literal will be generated 
even if it appears to duplicate another literal, if it is an A-type address 
constant containing a reference to the location counter. 


The following examples illustrate how literals are stored if each pair 
occurs under one LTORG statement: 


А(ж+4) Both аге stored 
ACx*-4) 

X'FFFF' The first is stored 
X'FFFF' 

ΧΙ 5.0: Both are stored 

HL3 0" 
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© 3.32.7 CNOP - Conditional No Operation 


The CNOP instruction allous the programmer to align an instruction at a 
specific word boundary. If any bytes must be skipped in order to align 

the instruction properly, the assembler insures an unbroken instruction flow 
by generating no-operation instructions. This facility is useful when calling 
sequences to establish a linkage to a subroutine and when parameter sequences 
are to be created. 


The CNOP instruction insures the alignment of the Location Counter setting to 
a half-word, word, or double-word boundary. If the Location Counter is 
already properly aligned, the CNOP instruction has no effect. If the specified 
alignment requires the Location Counter to be incremented, one to three no- 
operation instructions are generated, each of which uses two bytes. 


The CNOP instruction statement has the following format: 


ç Symbol, CNOP Two absolute expressions of the form b,w 
sequence 
symbol or 
blank 


Operand b specifies at which byte in a word or double word the Location 
Counter is to be set; b can be 0, 2, 4, or 6. Operand w specifies whether 
byte b is in a word (w=4) or double word (w=8). 

The following pairs of b and u are valid: 


b,w Specifies 


0,4 Beginning of a word 

2,65 Middle of a word (second half word) 

0,8 Beginning of a double word 

2,8 Second half word of a double word 

4,8 Middle (third half word or second word) of a double word 
6,8 Fourth half word of a double word 


Double word 


Word Word 


Half word Half word Half word Half word 


0,4 
0,8 


, 


2,4 0,4 2,4 
2,8 4,8 6,8 


Table 3-7: CNOP Alignment of the location counter 
Table 3-7 shows the position in a double word that each of these pairs 


specifies. Note that both 0,4 and 2,4 specify two different locations in 
a double word. 
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Assuming that the Location Counter is currently aligned at a double word 2 
boundary, then the CNOP instruction in this sequence: x 


Nane Operand 
CNOP 0,8 
BALR 2,14 


has no effect. However, this sequence: 


CNOP 6,8 
BALR 2,14 


causes three branch-on-conditions (no-operations) to be generated, thus 
aligning the BALR instruction at the last half word in a double word 
as follows: 


After the BALR instruction is generated, the Location Counter is at a double 
word boundary, thereby insuring an unbroken instruction flow. 
Note: 

If the Location Counter is on an odd-numbered byte-boundary when a CNOP 


instruction is encountered, normal alignment occurs before the CNOP is 
processed. 


3-96 Assembler V29.1C, U62-J-Z55-6-7600 


1/0 Control 
© 3.32.8 END - End Assembly 


The END instruction terminates the assembly of a program. It may also 
designate a point in the program or in a separately assembled program to 
which control may be transferred after the program is loaded. 


Points in separately assembled programs must be additionally identified in 
an EXTRN statement or as a V-type constant. The END instruction must always 
be the last statement in the source program. 


The format of the END instruction statement is as follows: 


A sequence A relocatable expression or blank 
symbol or 
blank 
© The operand specifies the point to which control may be transferred when 


loading is complete. 


For example: 


NAME 

AREA 50F 

BEGIN 2,0 
x,2 
BEGIN 
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3.32.9 COPY - Copy Library Member 


The COPY assembly statement is used to copy previously defined statement 
sequences from a library to a source program. 


Format: 


COPY Symbolic name 


The symbolic name is the name of the library member to be copied (see 
Note 4). It is formed in accordance with the syntax rules for symbolic 
addresses. 


Notes: 


— The statements to be copied are inserted immediately following the 
COPY statement. 


— The copied text is interpreted according to the preceding ICTL statement 
(if used). As this may be unintentional, a warning is issued: Error 
in COPY. 


— The copied text may not contain an ICTL or ISEQ statement. 


— The COPY member is initially sought as a TYPE=S member in the same 
program library as that in which the source program is contained. If the 
COPY member is not found there, it is sought as a TYPE-M member in the 
program libraries allocated by means of the link names ALTLIB, 

ALTLIB2 to ALTLIB5. 


A search for a COPY member is made in the $TSOS.MACROLIB only if the 
COPY statement is included in a macro from the system macro library. 


— If several members exist in the source or macro section of a program 
library that have the same name but different version numbers, the 
member having the highest number is used. 


— COPY calls may be nested to a depth of 5 and may occur in source 
or macro instructions. 


Copied statements may contain macro definitions unless they are 
themselves part of a macro. 


— The printing of the copied statements can be permitted with PRINT COPY 
and suppressed with PRINT NOCOPY (see 3.31.4). 


— The name of the member to be copied must not be generated. 
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- Example: 


In this example the COPYCOD1 library member (cf. note 6) is inserted in the 
program to be assembled. 


COPY COPYCOD1 
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3.32.10 OPSYN — Redefine Mnemonic Operation Code 2 


The OPSYN statement is used to define a mnemonic operation code which is 
equivalent to another operation code or macro name, or to cancel an 
operation code for subsequent program statements. 


Format: 
Symbol OPSYN Symbol or blank 


The name field symbol is assigned the attributes of the operand field symbol. 

If the operand field is blank, the name field symbol is deactivated; that is, 

it will no longer be recognized as a mnemonic operation code. The name field 

symbol must be built according to the rules for symbolic addresses. It may 

also be the name of an assembly statement; if so, that statement will be 

redefined or canceled. If it is canceled, then subsequent statements 

carrying the same name will be processed as macro instructions. ә 


The operand field symbol may be: 


— A machine or assembly instruction 
— A statement previously defined by another OPSYN 
— A macro name 


The OPSYN statement may appear anywhere in the program outside macro 
definitions. An OPSYN-defined operation code remains valid for all 
subsequent statements up to the end of the program or until redefinition 

by another OPSYN statement. Operation codes in statements within source 
program macros are analyzed according to the OPSYN statements preceding 

the macro definition. Operation codes in statements within library macros 
are governed by the OPSYN statements valid at the time of the END statement. 


An OPSYN-defined symbol retains its assigned meaning even if the 
operand field symbol of that OPSYN statement is later redefined by another 


OPSYN. 
An OPSYN-defined symbol retains its assigned meaning even if the operand 3 
field symbol of that OPSYN statement is later redefined by another OPSYN. 


An OPSYN statement carrying the same symbol in its name and operand fields 
causes that symbol to be redefined to its initial definition. 
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© Examples of valid OPSYN statements: 
EOJ OPSYN TERM Redefines the macro TERM 
STHH OPSYN STH Redefines the machine instruction STH 
x The following statement cancels STH as a 


machine instruction: 


STH OPSYN 
ABC OPSYN STHH Introduces "АВС" additionally and with the 
same effect as STHH. 
x The following statement cancels STHH, with ABC 
x continuing to define the machine instructions STH. 


STHH OPSYN 
STH OPSYN STH Readmits the machine instruction STH in its 
original meaning. 


3.32.11 STACK — Store PRINT, USING Status 


The STACK statement is used for storing the USING status (i.e. the base 
registers and their functions) and the current PRINT parameters. 


Format: 

Sequence STACK Sequence of operands PRINT or USING 
symbol or 

blank 


The PRINT and USING status may be stored up to four times after one another 
without a subsequent UNSTK statement. 


3.32.12 UNSTK - Reset PRINT, USING Status 


The UNSTK statement is used for resetting the USING or PRINT status stored 
with the STACK statement (see STACK). 


Format: 

Sequence UNSTK Sequence of operands PRINT or USING 
symbol or 

blank 


Every UNSTK statement must be preceded by a corresponding STACK statement. 
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ç 5 MACRO LANGUAGE 


4.1 GENERAL 


The macro language facilities allow frequently used sequences of assembly 
statements to be written once, in a standardized form - a macro definition — 
and generated within a program by writing only a single statement, a macro 
instruction, whenever the particular sequence of statements is desired. 

This facility simplifies the coding of programs, reduces programming errors 
and permits the standardization of coding that is used for frequently needed 
functions. i 


Conditional assembly and SET instructions provide the programmer with a 
convenient way to vary the format and number of statements that appear 

© within his program, according to conditions evaluated at assembly time. 
When used within a macro definition, the conditional assembly statements may 


be used to vary the statements that are generated for each occurrence of a 
macro instruction. 


4.2 THE MACRO INSTRUCTION STATEMENT 


A Macro Instruction Statement (hereafter called a macro instruction) is a 
source program statement which, through the parameters which are written 
in the operand entry, provides the assembler with information needed to 
generate source statements from a corresponding macro definition. 
Four types of macro instructions may be used: 

C e Positional macro instruction 
@ Keyword macro instruction 
e Mixed mode macro instruction 


e Macro call in alternate statement form 


The operands of a positional macro instruction must appear in a fixed 
order. 


Keyword macro instruction operands may be specified in any order. 


Mixed mode instruction operands may be either positional or keyword. Each 
type of operand is discussed in more detail in subsequent sections. 
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4-3 THE MACRO DEFINITION 


* 4 


A macro definition must be available to the assembler before a macro 
instruction can be processed. The macro definition contains the machine 
instructions and assembly statements with which the programmer wishes 

to replace every occurrence of the corresponding macro instruction; it also 
contains the SET and conditional assembly instructions which control the 
format and sequence of these statements. 


Every macro definition consists of: 
1. A header statement. 
2. A macro instruction prototype statement. 


3. Zero or more model statements, which may be assembly and machine 
instructions, SET and conditional statements, or MNOTE statements. 


4. A trailer statement. 


Each class of statements is described in detail in succeeding sections 
of this publication. 


THE MACRO LIBRARY 


The same macro definition may be made available to more than one source 
program by placing the macro definition in a macro library. The macro 

library is a collection of macro definitions that can be referenced by all 
assembly language programs in an installation. Once a macro definition has 
been placed in the macro library, it may be used by writing the corresponding 
macro instruction in a source program. 


The programmer may also keep private macro libraries to be used in 
conjunction with the system macro library (see 2.4 item 5 and 2.7.2). The 
procedures for placing macro definitions in the system macro library or in 
the user's private library are described in the Utilities Manual (MLU) and 
in the LMS Reference Manual. The search hierarchy of the macros in the 
libraries is discussed in section 2.7.3. 
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ç 4-5 VARYING THE GENERATED STATEMENTS 


Conditional assembly instructions may be used to control the number and 
sequence of statements that appear in a source program or replace a macro 
instruction. The formats of generated statements may be varied by the use of 
variable symbols and the SET instructions. Variable symbols are symbols whose 
contents may be changed by the programmer or the assembler. Each occurrence 
of a variable symbol in a model statement of a macro definition or ina 
source language statement is replaced by the current value assigned to the 
symbol. 


4.5.1 Types of Variable Symbols 


There are three types of variable symbols: 


ç 1. Symbolic parameters, which are assigned values by the programmer 
when he writes a macro instruction. 


2. System variable symbols, which are assigned values by the assembler 
each time it processes a macro definition. 


3. SET symbols, which are assigned values by the programmer inside and 
outside macro definitions. 


Variable symbols may be global or local. Global variable symbols may be used 
to communicate information between macro definitions and between a macro 
definition and the source program. Local variable symbols are provided for 
temporary usage within a single macro definition or in the source program. 
The values of local variable symbols used in a macro definition are not 
accessible outside the definition, nor are they preserved between macro 
definitions. Symbolic parameters and system variable symbols are local 
variable symbols. SET symbols may be defined as either local or global. 


Assembler V29.1C, U62-J-255-6-7600 4-3 


Macro language 


4.6 


HOW TO PREPARE MACRO DEFINITIONS 


A macro definition must be available to the assembler before it can process 
any macro instruction which references it. The macro definition must appear 
in the source program before any occurrence of the corresponding macro 
instruction or must be in the system macro library or one of the user macro 
libraries. 


A macro definition consist of: 

1. A macro definition header statement. 

2. Α macro instruction prototype statement. 

3. Zero or more model statements, which may be assembly and machine 
instructions, conditional assembly and SET instructions, and MNOTE 


statements. 


4. A macro definition trailer statement. 


&.6.1 MACRO - Macro Definition Header 


The macro definition header statement denotes the beginning of a macro 
definition. It must be the first statement in every macro instruction. 
Comment lines may precede a header statement in library macros but are 
ignored. 


The format of this statement is: 


Name Operation Operand 


Blank MACRO Not used 


4.6.2 MEND - Macro Definition Trailer 


The macro definition trailer statement denotes the end of a macro definition. 
It must be the last statement in every macro definition. 


The format of this statement is: 


Sequence Not used 
symbol or 
blank 
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MACRO INSTRUCTION PROTOTYPE 


The macro instruction prototype statement (hereafter called the prototype 
statement) specifies the name entry, mnemonic operation code, and the format 
of all macro instructions that refer to this macro definition. It must be 
the second statement of every macro definition. 


Macro definitions are classified according to the type of prototype statement 
that is used. The prototype may be written in one of four formats: 
positional, keyword, mixed mode or alternate statement form. 


Positional Prototype Statement 


Positional macro definitions are used when only a small number of operands 
will be supplied in the macro instruction or when the number of operands 
cannot be predetermined (see discussion of &SYSLIST). 


The positional prototype statement is written in the following form: 


A symbolic| A symbol Zero or more symbolic parameters, separated 
parameter (mnemonic by commas 
or blank operation code 


The symbolic parameters that appear in the positional prototype statement 
represent the corresponding fields in the associated macro instruction. A 
complete description of symbolic parameters follows the discussion of 
Model Statements. 


The symbol in the operation fields is the mnemonic operation code that must 
appear in the corresponding field of all macro instructions that are to 
reference this macro definition. The mnemonic operation code of every macro 
definition in a source program must be unique and may not be the same as 
any machine or assembly instruction. 


The following example illustrates a positional prototype statement, with two 
symbolic parameters: 


&NAME MOVE &TO,&FROM 
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4.7.2 Keyword Prototype Statement 2 


A keyword macro definition enables the programmer to reduce the number of 
operands that must be specified in each corresponding macro instruction, to 
write the operands in any order, and to assign preliminary values to the 
symbolic parameters that appear in the operand of the prototype statement. 
These values are used while processing the macro definition, unless the 
programmer supplies a new value for the symbolic parameter when he writes 
the macro instruction. 


Keyword macro definitions are useful when a macro instruction may have 

many operands, but normally specifies only a few. In this case, the omitted 
parameters are assigned the standard values that were written in the 
prototype statement. 


A keyword macro definition is identical to a positional macro definition, 
except for the operand entry of the prototype statement. 


The format of this statement is: 


A symbolic A symbol One or more operands in the form described 
parameter or| (mnemonic below, separated by commas 
blank operation code) 


Each operand consists of a symbolic parameter immediately followed by an 
equal sign and optionally followed by a value. If the value is not desired 
or is unnecessary, the equal sign must be immediately followed by the comma 
that separates the parameter from the next one, or by a space if it is the 
last parameter. 


Anything that may be used as an operand in a positional macro instruction, 


except variable symbols, may be used as a standard value in the keyword 
prototype statement. | 


The following are valid keyword prototype operands: 


&READER- ә 


&LOOP2-SYMBOL 
&S4-F'4096' 
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S The following are invalid keyword prototype operands: 
CARD (not a symbolic parameter) 
&TYPE (not followed by an = sign) 
&TWO =123 (equal sign does not immediately follow the symbolic 
parameter) 
&A- X'01' (space betueen equal sign and value) 
&B-A&AGI (variable symbol in standard value) 


A valid keyword prototype statement with four operands is illustrated in the 
next example. Note that only two parameters have been given standard values. 


&N MOVE &R=2,8A=S,81=,8F= 


4.7.3 Mixed-Mode Prototype Statement 
Mixed-mode macro definitions allow the programmer to combine features of 
keyword and positional macro definitions in the same macro definition. 


The format of the mixed-mode prototype statement is: 


A symbolic Two or more operands of the form described 
parameter below, separated by commas 
or blank 


The operands must be valid operands of positional and keyword prototype 

statements. All positional operands must precede the first keyword operand. 

The rules for forming positional and keyword operands have been discussed 
© earlier in this section. 


The following mixed-mode prototype statement illustrates two positional 
operands and two keyword operands. 


&N MOVE &T,&P,&TO-,&F-3 
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4. 7. 4 Alternate Statement Form 


The prototype statement may be written in a form different from that used 
for machine or assembly instructions. The normal form is described in 
section 3.1.1. of this publication. The alternate form described here allows 
the programmer to write an operand on each line, and allows the inter- 
spersing of operands and comments in the statement. 


In the alternate form, as in the normal form, the name and operation entries 
must appear on the first line of the statement, and at least one blank must 
follow the operation entry on that line. Both types of statement forms may 
be used in the same prototype statement. 


The rules for using the alternate statement form are: 


1. If an operand is followed by a comma and a blank (40),, and the column 
after the end column contains a non-blank character, the operand entry 
may be continued on the next line starting in the continue column. More 
than one operand may appear on the same line. 


2. Comments may appear after the blank that indicates the end of an operand, 
up to and including the end column. 


j. If an operand is followed by a blank, it indicates the end of the 
operand field. Comments may appear up to the end column. If a character 
other than blank appears in this line in the column following the end 
column, the comment field is continued in the next line, beginning in the 
continuation column. 


Note 


A prototype statement may be written on as many continuation lines as there 
are operands and associated comments. 

The following examples illustrate: 

1. the normal statement form 

2. the alternate statement form, and 


3. the combination of both forms, for a positional prototype statement. 


&МАМЕ 1 ОРІ : &OPERND1,&OPERND2 , &OPERND3 X 
Normal Form 
&NAME2 &OPERND1, X 
&OPERND2,&OPERND3 X 
Alternate Statement Form 
&NAME3 SOPERND1, X 
SOPERND2,&0PERND3,&OPERND4G, X 
&OPERND5 X 


Combination of both Forms 
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MODEL STATEMENTS 


Model statements are the macro definition statements from which the desired 
sequences of machine and assembly instructions are generated. Any number of 
model statements may follow the prototype statement. A model statement 
consists of one to four entries. They are, from left to right, the name, 
operation, operand, and comments entry. 


The name entry may be an ordinary symbol, a sequence symbol, a variable 
symbol, or a combination of variable symbols and alphanumeric characters 
which generate an ordinary symbol, depending on the particular statement 
(see discussion of concatenation, section 4.10). * and .* may be generated 
by variable symbols in the begin column of a model statement. 


The operation entry of a model statement may contain any machine, assembly, 
or macro instruction mnemonic operation code, except ICTL, ISEQ and MACRO; 
or it may contain a variable symbol. Variable symbols may not be used to 
generate the following operation codes: 


ICTL, ISEQ, REPRO, START, COM, MACRO, MEND, MEXIT, MNOTE, LCLA, LCLB, LCLC, 
GBLA, GBLB, GBLC, SETA, SETC, SET, AIF, AIFB, AGO, AGOB, ANOP and ACTR. 


Variable symbols may not be used to generate macro instruction operation 
codes, except in special cases (see MCALL statement, 4.13.9). 


Variable symbols may be used in assembly language statements outside macro 
definitions under the same restrictions as given above for macro model 
statements. Note, however, that symbolic parameters may not be used outside 
macro definitions and that the presence of variable symbols in a statement 
may inhibit complete attribute processing (see discussion of "Attributes", 
section 4.15). 


The operand entry may contain ordinary symbols, variable symbols, and other 
assembly language elements in accordance with the rules for paired 
apostrophes, ampersands and blanks (see section 4.13.1, "Macro Instruction 
Operands"). After all variable symbol substitution has been completed, the 
resulting operand field must not extend over more than two continuation 
lines. 


The comments entry may contain any combination of characters. Variable 
symbols that occur within the comments field are not replaced. Similarly, 
the line following a REPRO statement may not be generated by variable 
symbols. 


A single variable symbol may not be used to generate more than one entry, 
but more than one variable symbol may appear in the same model statement. 
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SYMBOLIC PARAMETERS » 


A symbolic parameter is a type of variable symbol that is assigned a value 
by the programmer each time he writes a macro instruction or, for a keyword 
or mixed mode macro definition, the macro prototype statement. Symbolic 
parameters may be used wherever variable symbols are permitted unless 
otherwise stated. By changing the values assigned to symbolic parameters, 
the programmer can vary the statements that are generated or each occurrence 
of a macro instruction. The value of a symbolic parameter may also be 
assigned or changed using a SETC statement. 


A symbolic parameter consists of an & followed by 1 to 7 alphanumeric 
characters (letters and digits), the first of which must be a letter. 


The programmer should not use any symbolic parameters which begin with &SYS 
(see 4.14.1 last paragraph). 


The same variable symbol may not be redefined as a symbolic parameter and 
as a SET symbol in the same macro definition. 2 


The same symbolic parameter may be used in two or more macro definitions 
within a single program. 


The following are valid symbolic parameters: 


&READER &LOOP2 
&A &S4 
&X4F2 


The following are invalid symbolic parameters: 


&256B (first character after the ampersand is not a letter) 
&AREA2456 (more than seven characters after the ampersand) 

&BCD( 34) (contains a special character other than the initial ampersand) 
&IN_AREA (contains a special character other than the initial ampersand) 
&SYSTEM (is the system variable symbol &SYSTEM) 


Any symbolic parameters that are used within a macro definition must appear 
in the macro definition prototype. Parameters in model statements are 
replaced by the characters that currently correspond to them. 23 


The following keyword macro definition illustrates the use of symbolic 
parameters in model statements. Note that one symbolic parameter has been 
given a value in the prototype. This value will be used unless a new one 
is assigned in the macro instruction. 


Header 

Prototype &NAME KTO, &FROM=WORK 
Model &NAME 2,SAVE 

Model 2 ,&FROM 

Model 2,&TO 

Model 2,SAVE 

Trailer 
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C In the following example, the symbols HERE, FIELDA, and FIELDB are written 
in the MOVE macro instruction to correspond to the symbolic parameters 
&NAME , &TO, and &FROM, respectively, of the MOVE prototype statement. 


HERE MOVE TO=FIELDA, FROM=FIELDB 


The following assembly language statements would be generated by the 
preceding macro instruction. 


HERE ST 2, SAVE 
L 2,FIELDB 
ST 2,FIELDA 
L 2,SAVE 


The generated statements can be varied by changing the values of the 
symbolic parameters supplied in the macro instruction, as illustrated 
in the following example. 


LABEL MOVE TO=IN, FROM=OUT 
LABEL ST 2, SAVE 

L 2,0UT 

ST 2,IN 

L 2,SAVE 


A symbolic parameter will not be replaced if it appears in the comments field 
of a model statement. 
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CONCATENATION 


If a variable symbol in model statement is immediately preceded or followed 
by other characters or variable symbols, the characters that correspond to the 
variable symbol are combined, in the generated statement, with the other 
characters or with the characters that correspond to the other variable 
symbols. This process is called concatenation. 


The macro definition, macro instruction, and generated statements that 
follow illustrate the rules for concatenating symbolic parameters with 
other characters or other symbolic parameters. 

Additional concatenation techniques are described in the discussion of 
"Evaluation of Character Expressions", section 4. 17. 2. 3. 


Header 

Prototype &NAME &ТҮ,&Р,&ТО,&РЕОМ 
Model &NAME 2, SAVEAREA 

Model 2,&P&FROM 

Model 2,&P&TO 

Model 2, SAVEAREA 
Trailer 2, SAVEAREA 


Generated STD 2, SAVEAREA 
Generated LD 2,FIELDB 
Generated STD 2,FIELDA 
Generated LD 2, SAVEAREA 


The symbolic parameter &TY is used in each of the four model statements 

to vary the mnemonic operation code of each of the generated statements. 

The character D in the macro instruction corresponds to symbolic parameter 
ΣΤΥ. Since ΣΤΥ is preceded by other characters (i.e., ST and L) in the model 
statements, the character that corresponds to &TY (i.e., D) is concatenated 
with the other characters to form the operation fields of the generated 
statements. 


The symbolic parameters &P, ΣΤΟ, and &FROM are used in two of the model 
statements to vary part of the operand fields of the corresponding generated 
statements. The character FIELD, A, and B correspond to the symbolic 
parameters &P, &TO, and &FROM, respectively. Since &P is followed by & FROM 
in the second model statement, the characters that correspond to them (i.e., 
FIELD and B) are concatenated to form part of the operand field of the 
second generated statement. Similarly, FIELD and Α are concatenated to form 
part of the operand field of the third generated statement. 


If the programmer wishes to concatenate a symbolic parameter with a letter, 
digit, left parenthesis, or period following the symbolic parameter, he 
must immediately follow the symbolic parameter with a period. A period is 
optional if the symbolic parameter is to be concatenated with another 
symbolic parameter, or a special character other than a left parenthesis 
or another period that follows it. 


If a symbolic parameter is immediately followed by a period, then the 
symbolic parameter and the period are replaced by the characters that 
correspond to the symbolic parameter. A period that immediately follous 
a symbolic parameter does not appear in the generated statement. 
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In the following examples, assume the symbolic parameter &PARAM has a 


value of A. 


Model Statement Representation 


Generated Characters 


&PARAM. (BC) ACBC) 
&PARAM. . BC A. BC 
&PARAM. BC ABC 
£PARAM. 2BC A2BC 
&PARAM, . 2B A,.2B 
BC&PARAM BCA 
BC , PARAM BC,A 
B2&PARAM B2A 
&PARAM. £PARAM AA 
&PARAM&PARAM AA 
SPARAM. . £PARAM Α.Α 


The following macro definition, macro instruction, and generated 


statements illustrate these rules. 


Header 

Prototype KP, KS, &R1,&R?2 

Model &R1,&S.(&R2) 

Model &R1,&P.B 

Model &R1,&P.A 

Model &R1,&S.(&R2) 

Trailer 

Macro FIELD,SAVE,2,4 

Generated 2, SAVE( 4) 

Generated 2,FIELDB 

Generated 2,FIELDA 

Generated 2, SAVE(4) 

The symbolic parameter &P is used in the second and third model 
ç statements to varv part of the operand field of each of the corresponding 


generated statements. The characters FIELD of the macro instruction correspond 
to &P. Since &P is to be concatenated with a letter (i.e., B and A) in each 
of the statements, a period immediately follows &P in each of the model 
statements. The period does not appear in the generated statements. 


Similarly, symbolic parameter &S is used in the first and fourth model 
statements. In the operand of the corresponding statements &S is followed 


by a period, because it is to be concatenated with a left parenthesis. 
The period does not appear in the generated statements. 
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4.11 MNOTE STATEMENT 


An MNOTE statement may be used as a model statement in a macro definition 
or in the source program. 

It may be used to generate a variable message between source statements or 
in a macro expansion. 


The format of the MNOTE statement is: 


A MNOTE nnn 

sequence | [character string" 
symbol or x 

blank 0 < nnn < 255 


The error code may be generated by a variable symbol. 


The error code (nnn) may contain a maximum of 3 digits; leading zeros are 
permitted. 


If the error code is omitted, 0 is assumed. 
If the error code is not an integer or is omitted, the statement will be 
treated as an error message and listed like other invalid model statements 


even if PRINT NOGEN is specified. 


The following relationship exists between the error codes of the MNOTES 
and the error classes of the assembler flags: 


Error code = 0 Error class 0 Warning 
0 < Error code S 150 Error class 1 Error 
150 < Error code S 254 Error class 2 Severe error 
Error code = 255 Error class 3 Fatal error 


It is thus possible to terminate the assembly prematurely by generating a 
MNOTE with error code 255. In this case the assembler simply outputs an 
ERROR POOL. 


If the error code is an asterisk, the operand field of the MNOTE statement 
will be listed as a comments statement, in the generated code, even if 
PRINT NOGEN is specified. The MNOTE operation code and the apostrophes 
enclosing the message will not appear. | 


At the end of the assembly listing the diagnostic listing is followed by a 
listing of the MNOTES in accordance with the error codes. Cross-references 
are specified for each error code. 


MNOTE X.. . is assigned no error weight, i.e., the end message reports 
HIGHEST ERROR HEIGHT: -, unless other warnings or errors occurred. 


Variable symbols in the operand field of either form of the MNOTE statement 
will be replaced by their current values. In accordance with the rules 

for model statement operand fields, two apostrophes must be used to generate 
a single apostrophe. If ampersands that are not part of a variable symbol 
are used, then two ampersands must be written. In contrast to assembly 
language they are used as two separate characters. An inquiry for an 
ampersand may be entered by means of a partial character string ('8&'(1,1)). 
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ç 4.12 COMMENTS STATEMENTS 


A model statement may be a comments statement. A comments statement 
consists of an asterisk in the begin column, followed by comments. The 
comments statement is used by the assembler to generate an assembly 
language comments statement, just as other model statements are used by the 
assembler to generate assembly language statements. 


The programmer may also write comments statements in a macro definition 
which are not to be generated. They are used for documentation purposes 
only. These statements must have a period in the begin column, immediately 
followed by an asterisk and the comments. 


If in a library macro a header statement is preceded by comment lines 
(asterisk in first column) such lines are ignored. 


The first statement in the following example will be used by the assembler 
to generate a comments statement; the second statement will not. 


X THIS STATEMENT WILL BE GENERATED 
.X THIS ONE WILL NOT BE GENERATED 


Generation of comments cards 


The macro language makes it possible to generate comments from statements 
and instructions, thus deactivating their function. It is however not 
possible to generate any kind of comments. 


Statements which are allowed to have a symbol in the name field are written 

in the source program with a variable SETC symbol as name. If this variable is 
assigned an *** by generation in the macro processor, then the corresponding 
statement is made ineffective and is logged as comments. 


The logging of the generated comments is suppressed if the variable SETC 
symbol is assigned the identifier of macro comments „. 


- Note: 


It is true that the effect of macro instructions will at the same time be 
nullified, but on account of the assembler structure it is not possible 
to prevent them from being read in. 
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4.13 


MACRO INSTRUCTIONS 


A macro instruction is an assembly language statement that represents a 
variable sequence of statements which are written in a corresponding macro 
definition. Each occurrence of a macro instruction will be replaced by se- 
lected statements from the macro definition. The form of the generated state- 
ments can be controlled by varying the operands of the macro instruction. 


There are four types of macro instructions corresponding to the four macro 
definition types. They are: positional, keyword, mixed mode and alternate 
format (see section 4. 13.2. 


4.13.1 Macro Instruction Operands 


4-16 


Any combination of up to 127 characters may be used as a macro instruction 
operand provided that the following rules are observed. These rules apply to 
the format of macro instruction operands before substitution for variable 
symbols. 


Paired Apostrophes: An operand may contain apostrophes, provided they 
occur in pairs. Two apostrophes must be used to represent a single apostrophe 
that appears between paired apostrophes. 


In the example below, the first and fourth apostrophes, and the fifth and 
sixth apostrophes are paired apostrophes. 


"А" BCD 


An apostrophe immediately followed by a letter and immediately preceded by 
the letter L (when L is preceded by any character other than an &) is not 

considered in determining paired apostrophes. For instance, L'SYMBOL is a 

valid operand. 


Paired Parentheses: An operand must contain an equal number of left and 
right parentheses. The nth left parenthesis must appear to the left of the 
nth right parenthesis. A left parenthesis and a following right parenthesis 
without any other intervening parentheses, form a set of paired parentheses. 
If there is more than one pair, each additional pair is determined by re- 
moving any pairs already recognized and reapplying the above rule for paired 
parentheses. In the following example, the first and fourth, the second and 
third, and the fifth and sixth parentheses are paired parentheses. 


QCACB) ,C) DCE) 
If an operand begins with a left parenthesis, it must terminate with a 
matching right parenthesis and will be treated as a sublist (see Operand 


Sublists). 


Any remainder on the right of the right parenthesis is ignored (this applies 
particularly to arithmetic expressions) and the line is flagged. 
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© А parenthesis that appears between paired apostrophes is not considered in 
determining paired parentheses. For instance, in the following example the 
middle parenthesis is not considered. 
ο) 
Equal Signs: An equal sign can only occur as the first character in an 
operand or between paired apostrophes or paired parentheses. The following 
examples illustrate these rules. 
=Е* 32" κ E(F=G) 
Ampersands (8): Each sequence of consecutive ampersands must contain an 
even number, except when the ampersand is part of a variable symbol. The fol- 


lowing example illustrates this rule. 


Example: &&123&&&& 
© Commas: А comma indicates the end of ап operand, unless it is placed 
between paired apostrophes or paired parentheses. The following examples 


illustrate this rule. 


Example: (A,B)C*," 


Blanks: A blank indicates the end of the operand entry. 

Exceptions: It meets the statement format requirements (see 3.1.1.3) or it 
is placed between paired apostrophes. The following example 
illustrates this rule. 


Example: "А B С" 


The following are valid macro instruction operands: 


SYMBOL A+2 
123 (TO(8) , FROM) 
X' 189A" 0(2,3) 
ç x -F'4096"' 
L'NAME АВ&& 9 
"ТЕМ = 10" "PARENTHESIS IS)' 


"СОММА IS,’ "APOSTROPHE 15:33 


The following are invalid macro instruction operands: 


W NAME odd number of apostrophes 
5А) В number of left parentheses does not equal number of 
right parentheses 
(15 B) blank not placed between paired apostrophes 
ONE“ 1511" blank not placed between paired apostrophes 
(A,B Α operand begins with a left parenthesis, but does not ter- 


minate with a right parenthesis 
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Variable Symbols: Variable symbols may appear in the operand field of a ә 
macro instruction. Only SET variable symbols may be used in an outer macro 
instruction, while symbolic parameters, system variable symbols and SET 

symbols may be used in an inner macro instruction (see discussion of 

"Inner Macro Instructions", section 4.13.7). Variable symbols will be re- 

placed by the values currently assigned to them as the macro instruction 

operands are processed. 


Operand Sublists: An operand of a macro instruction may be a sublist. 

A sublist consists of one or more operands separated by commas and enclosed 
in paired parentheses. The entire sublist, including the parentheses is com 
sidered to be one macro instruction operand. The limit of 127 characters per 
operand applies to the entire sublist, including all suboperands, commas, 
and parentheses (cf Appendix A9, item 12). 


Sublists provide the programmer with a convenient way of referring to: 
1. a collection of operands as a single operand or 
2. a single operand within a collection of operands. 23 


Sublists may be nested to any level. The value and attributes of any sub- 
operand of an outer or inner level sublist are accessible under the restric- 
tions discussed in "Attributes", section 4.15. Other suboperands are handled 
in the same way as omitted positional operands. 


If Pl is a symbolic parameter in a prototype statement, and the correspon- 
ding operand of a macro instruction is a sublist, then &Pl(n) may be used 
in a model statement to refer to the nth operand of the sublist, where n 
may be any arithmetic expression allowed in a SETA instruction (see section 
4.17.1 for details on the SETA instruction). If &Pl(n) is, in turn, a sub- 
list, then &Pl(n,m) may be used to refer to the nth sub-operand of the 
inner sublist. 


Indexing may be extended to refer to any element within any level of sublist. 


The following examples illustrate the use of indexing to refer to statements. 
&P is a symbolic parameter and has a value (A,((B,C),)). 


Model Statement Representation Generated Characters 23 
&P( 1) A 

&P(2, 1) (B,C) 

&Р(2, 2) null 

&P( 1,1) A 

&P (A,((B,C) ,)) 

&P( 2,3) null 

&Р(1, 2) null 

&P(2,1,2) С 

Note 


that if the sublist notation is used, and the operand is not a sublist 
(or its equivalent for an inner sublist), &P(1) refers to the entire 
operand, and &P(m), where m 2 2, refers to a null character value. 
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© The following macro definition, macro instruction and generated statements 
further illustrate the use of sublists. 


Header MACRO Te 
Prototype ADDNUM &NUM,&REG,&AREA 
Model REG, &NUM( 1) 
Model &REG, &NUM( 2) 
Model REG, &NUM( 3) 
Model &REG,£&AREA 
Trailer 


Macro (A,B,C) ,6,SUM 
Generated 
Generated 
Generated 
Generated 


The operand of the macro instruction that corresponds to symbolic parameter 
&NUM is a sublist. One of the operands in the sublist is referred to in the 
operand entry of three of the model statements. For example, &NUM(1) refers 
to the first operand in the sublist corresponding to symbolic parameter &NUM. 
The first operand of the sublist is A. Therefore, A replaces &NUM(1) to form 
part of the generated statement. 


Note 


When referring to an operand in a sublist, the left parenthesis of the 
sublist notation must immediately follow the last character of the 
symbolic parameter, e.g., &NUM(1). A period should not be placed between 
the left parenthesis and the last character of the symbolic parameter. A 
period must be used between these two characters only when the programmer 
wants to concatenate the left parenthesis with the characters that the 
symbolic parameter represents. The following example shows what would be 
generated if a period appeared between the left parenthesis and the last 
character of the symbolic parameter in the first model statement of the 
above example. 


Prototype ОЙ EMEN а &NUM,&REG,&AREA 
Model L &REG,&NUM. ( 1) 
Macro Porc CAE ° | (A,B,C) ,6,SUM 
Generated E 6, (A, B, C) (1) 


The symbolic parameter &NUM is used in the operand entry of the model 
statement. The characters (A,B,C) of the macro instruction correspond to 
&NUM. Since &NUM is immediately followed by a period, &NUM and the period 
are replaced by (A,B,C). The period does not appear in the generated state- 
ment. The resulting generated statement is an invalid assembly language 
statement. 
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&.13.2 Positional Macro Instruction 


The format of a positional macro instruction is: 


A symbol, Mnemonic Zero or more operands separated by commas 
sequence operation 

symbol , code 

or blank 


The name entry of the macro instruction may contain a symbol. The symbol 
will not be defined in the generation process unless a symbolic parameter 
appears in the name entry of the prototype and the same parameter appears 
in the name entry of a generated model statement. 


The operation entry contains the mnemonic operation code of the macro 
instruction. It must be the same as the mnemonic operation code of a macro 
definition prototype statement in the source program or in the system or 
user macro library. 


The macro definition with the same mnemonic operation code in the prototype 
statement is used by the assembler to process the macro instruction. If a 
macro definition in the source program and one in a macro library have the 
same mnemonic operation code, the source program definition will be used. 
If a macro definition in a user's macro library has the same mnemonic 
operation code as in the system macro library, the user's macro defini- 
tion will be used. 


The position and order of the operands in a positional macro instruction 

are determined by position and order of the symbolic parameters in the 
operand of the corresponding prototype statement. The number of operands 
that appear in the positional macro instruction operand may be greater than 
the number of symbolic parameters that are written in the prototype state- 
ment. In this case, the &SYSLIST facility may be used to reference the addi- 
tional operands (see section 4.14.1.3). 
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S &. 13.3 Omitted Operands 


If an operand that appears in the positional prototype statement is omitted 
from the macro instruction, then the comma that would have separated it 
from the next operand must be present. If the last n positional operands 
are omitted, the last n commas may be omitted. 


Omitting an operand from a macro instruction causes the corresponding sym- 
bolic parameter to be assigned the null string (not a character) as the 
character value (as operand in the SETC statements or in character relations). 
As an arithmetic value it has the null value (in arithmetic relations or as 
the operand of an SETA statement). 


The rules for writing macro instruction operands and examples of positional 
macro instruction are given below. 


© 4.13.4 Keyword Macro Instruction 


A keyword macro definition is used by writing a keyword macro instruction. 


The format of this type of macro instruction is: 


A symbol, Mnemonic Zero or more operands in the form described 
sequence Operation below, separated by commas. 

symbol, Code 

or blank 


Each operand consists of a keyword beginning with a letter and followed 
immediately by an equal sign and an optional value. A keyword is a symbolic 
parameter, written without the initial ampersand, that appears in the corres- 
ponding macro definition prototype statement. Any keywords used in the macro 
instruction must appear in the associated macro definition prototype. 


© The rules for specifying the value of a keyword are identical to the rules 
governing positional macro instruction operands. Anything that may be used 
as an operand in a positional macro instruction may be used as a value in a 
keyword macro instruction. Nested keywords are not permitted. 


Keyword operands may be written in any order. Because of this feature, it 
is not necessary to supply the comma that separates operands whenever an 
operand is omitted. An operand which is omitted from the macro instruction 
and was not given a standard value in the prototype statement will be 
assigned a null character value. 


Symbolic parameters used in keyword macro prototypes assume the values 
assigned to them in the macro instruction. 


The rules under which the assembler replaces symbolic parameters in model 
statements with the values is described in Positional Macro Instructions. 
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The following examples illustrate a keyword macro definition, a keyword 2 
macro instruction and the resulting generated statements. 


Statement 1 assigns the values 2 and S to the symbolic parameters &R and ΣΑ, 
respectively. Statement 6 assigns the values FA, FB and THERE to the key- 
words T, F, and A, respectively. The symbol HERE is used in the name entry 
of statement 6.. 


Since a symbolic parameter (&N) appears in the name entry of the prototype 
statement (statement 1), and the corresponding characters (HERE) of the macro 
instruction (statement 6) are a symbol, &N is replaced by HERE in statement 2. 


£R-2,£A-S,£T-,£F- 
&R,&A 
&R,&F 
&R,&T 


&R,&A Q 


6 HERE T=FA,F=FB,A=THERE 


HERE 2, THERE 
2,FB 
2,FA 
2, THERE 


Since &T appears in the operand of statement 1, and statement 6 contains 
the keyword (T) that corresponds to &T, the value assigned to T (FA) re- 
places &T in statement 4. Similarly, FB and THERE replace ΣΕ and ΣΑ in 
statement 3 and in statements 2 and 5, respectively. Note that the value 
assigned to &A in statement 6 is used instead of the value assigned to &A 
in statement 1. 


Since &R appears in the operand of statement 1, and statement 6 does not corr- 


tain a corresponding keyword, the value assigned to &R in the prototype 
statement replaces &R in statements 2, 3, 4 and 5. 


4-22 Assembler V29.1C, U62-J-255-6-7600 


Macro instructions 
© 66, 13.5 Mixed Mode Macro Instruction 


The mixed mode macro instruction combines the features of positional and 
kevword macro instruction. The format of a mixed mode macro instruction is: 


A symbol, Mnemonic Two or more operands of the form described 
sequence Operation below, separated by commas 

symbol Code 

or blank 


The operand field is a combination of positional and keyword macro instruc- 
tion operands. All positional operands must precede the first keyword 
operand. The positional operands follow the rules for positional macro 
instructions and the keyword operands follow the rules for keyword macro 
instructions. 


S The following mixed mode macro definition, mixed mode macro instruction and 
generated statements illustrate these facilities. 


&N ΣΤ,3Ρ,89,38,ΣΤΟΞ,ΣΕ- ` 
&N &R,SAVE£Q 
&R,&P&F 
£R,£P£TO 
&R,SAVE 
HERE H,,,2,F-FB,TO-FA 
HERE STH 2,SAVE 
LH 2,FB 
STH 2,FA 
LH 2,SAVE 


4.13.6 Statement Form 


Note that the positional operands are in the same order in the macro in- 
struction as the symbolic parameters appear in the prototype statement. 
The omission of the second and third positional parameters is treated in 
the same manner as for a positional macro definition. The keyword operands 
are written in a different order than appeared in the prototype statement. 
The macro instruction may also conform to the alternate instruction 

format as discussed in section 4.7.4. 
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&.13.7 Inner Macro Instructions 
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Macro instructions may be written in the same alternate format that was 
discussed in section 4.7, "Macro Instruction Prototype". As many continuation 
lines as are needed to contain all operand entries and associated comments 
may be used. 


A positional, keyword or mixed mode macro instruction may be used as a 

model line in any macro definition. Macro instructions used in this Way 

are called inner macro instructions, in contrast to outer macro instructions, 
which appear outside macro definitions. 


If a macro definition is contained in the system macro library, the search 
for 'inner macro' is made normally in that library only. 


Any symbolic parameters used in an inner macro instruction are replaced 

by the corresponding operands of the outer macro instruction. Any ordinary 
symbols used as operands in an inner macro instruction will not be assigned 
attributes. The macro definition corresponding to an inner macro instruction 
is used to generate the statements that replace the inner macro instruction. 


The ADDNUM macro instruction of the previous example is used as an inner 
macro instruction in the following example. 


The inner macro instruction contains two symbolic parameters, &S and &T. The 
characters (X,Y,2) and J of the macro instruction correspond to £S and &T, 
respectively. Therefore, these characters replace the symbolic parameters in 
the operand entry of the inner macro instruction. 


The assembler then uses the macro definition that corresponds to the inner 


macro instruction. The fourth through seventh generated statements have been 
generated for the inner macro instruction. 


Assembler V29.1C, U62-J-255-6-7600 


Macro instructions 


Header 
Prototype &R1,&R2,&S,&T,&U 
Model &R1,&R2 
Model &R1,&T 
Model &U 
Inner Eu 88, 12,81 
Model &R1,&T 
MEND 
MACRO 
ADDNUM &NUM,&REG,&AREA 
&REG, &NUM( 1) 
REG, &NUM( 2) 
&REG , &NUM( 3) 
ΣΕΕΟ,ΣΑΚΕΑ 
© Outer Tuae 10, 11, (X, v, 2), J, k 
Generated SR 10,11 
C 10,J 
BNE k 
Generated L 12,X 
Generated A 12,Y 
Generated A 12,2 
Generated ST 12,4 
Generated A 10, J 
Note 


An ampersand that is part of a symbolic parameter is not considered in 
determining whether a macro instruction operand contains an even number 
of consecutive ampersands. 

The following may not be used as operands of an inner macro: 

1. A sublist, if it is generated in the outer macro via a SETC statement. 


| 
C 2. Α keyword operand (likewise). 


3. Several operands separated by commas. 
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4.13.8 Levels of Macro Instructions 


A macro definition that corresponds to an outer macro instruction may 
contain any number of inner macro instructions. The outer macro instruction 
is called a first level macro instruction. Each of the inner macro instruc- 
tions is called a second level macro instruction. 

The macro definition that corresponds to a second level macro instruction 
may contain any number of inner macro instructions. These macro instructions 
are called third level macro instructions, etc. 


The maximum number of levels of macro instructions that may be used is 255. 
The actual number depends on the complexity of the macro definition and the 
amount of storage available. If the limit is exceeded the macro expansion 
is terminated (see also Appendix Α.9). 


Only the numbers of the last two levels used appear in the Assembly Listing. 


4.13.9 Generated Macro Names in Macro Instructions 
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The OPCODE field of a statement may contain a symbolic parameter or a SETC 
symbol. The assigned current value is therefore a character string. The 
assembler can identify this character string as a macro name only if it is 
defined in a MCALL statement. In this case, the statement with the generated 
character string is interpreted as a macro call. 
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© 4.13.9.1 Define Macro Name (MCALL) 
This statement is used to define all macro names which are not directly 


called in the program but which are generated in a macro instruction. 


Format: 


Not used MCALL One or more macro names separated by commas 


Notes 


— Any number of MCALL statements may occur at any position inside or outside 
macro definitions. 


— MCALL statements may contain a maximum of 400 macro names. 


Example: 


MACRO1 and MACRO2 are two macros in a library. They are to be generated as 
‚inner macro instructions in MACRO3. 


MACRO <—— Definition of the outer macro 
MACRO3 &P 


MCALL MACRO1,MACRO2 <—— MCALL statement 


&P A,B «—— Symbolic macro instruction 


MACRO3 ΜΑΟΡΟΙ <—— Quter macro instruction 


MACRO1 A,B <— Generated macro instruction 
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4-14 "VARIABLE SYMBOLS AND SET INSTRUCTIONS 


Variable symbols may appear in macro definition model lines and in most 
assembly language source program statements outside macro definitions. Where 
the use of a term or an instruction outside macro definitions differs from 
its use within macro definitions, the difference will be described in the 
subsequent text. 


Nine instructions are provided to allow the programmer to define and use 
variable symbols, and in particular, the SET symbols. They are: 


LCLA GBLA SET(A) 
LCLB GBLB SET(B) 
LCLC GBLC SET(C) 


The LCLA, LCLB and LCLC instructions are used to define certain SET symbols 
as local variable symbols, and to assign them initial values. The GBLA, 
GBLB and GBLC instructions are used to define certain SET symbols as global 
variable symbols, and assign them initial values. 


The SET(A), SET(B) and SET(C) instructions are used to assign arithmetic, 
binary, and character values, respectively, to SET symbols. The SETB 
instruction is described after the SETA and SETC instructions. 


4.16.1 Variable Symbols 


Variable symbols may be used in assembly language statements to vary the 
format of generated coding. Variable symbols may also be used in conditional 
SET instructions to perform the arithmetic calculations, character 
manipulations, and logical operations which ultimately determine the sequence 
in which statements are assembled into a program. 

Variable symbols include SET symbols, symbolic parameters, and system 
variable symbols. 

System variable symbols (&SYSLIST, &SYSECT, &SYSNDX, %SYSVERM), like 
symbolic parameters, are local to a single macro definition. They are 
assigned values automatically by the assembler and can only be changed by 
the programmer by writing another macro instruction. 

SET symbols are variable symbols which may appear inside and outside macro 
definitions. SET symbols differ from symbolic parameters and system variable 
symbols in three ways: 


1. where they can be used in an assembly language program, 
2. how they are assigned values, and 
3j. hou the values assigned to them can be changed. 


The differences between the three types of variable symbols and their uses 
are described in detail below. 


The system variable symbols &SYSNDX, &SYSECT and &SYSLIST may be used in the 
name, operation and operand fields of macro definition model statements, but 
not in statements outside macro definitions. Furthermore, they may not be 
used as symbolic parameters or SET symbols, nor may they be assigned values 
by the SET instructions. The other system variable symbols are &SYSVERS, 
&SYSDATE, &SYSTEM, &SYSTIME, &SYSPARM and &SYSVERM. 
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S When new system symbols are introduced, these are again prefixed with &SYS. 
To avoid any collisions the following symbols must not begin with the 
character string &SYS: 


- Symbolic parameters 
- Variable symbols 
- SET symbols 


Φ. 14.1. 1 &SYSNDX 


The system variable symbol &SYSNDX represents a four-digit number that is 
assigned when any macro instruction is processed. This number is set to 
0001 for the first macro instruction and is incremented by one for each 
subsequent inner or outer macro instruction that is assembled. 


Throughout the processing of one macro definition, the value of &SYSNDX may 
be considered a constant, independent of any inner macro instructions in 

© that definition. Thus, &SYSNDX may be used to create unique names for 
statements generated from the same model statement, as illustrated in the 
examples below. 


If &SYSNDX is used in a generated model statement, SETC or ΜΝΟΤΕ instruction, 
or a character relation in a SETB or AIF instruction, the value substituted 
for &SYSNDX is the character representation of the four-digit number assigned 
to the current macro instruction being processed. 

If &SYSNDX appears in arithmetic expressions (e.g., in the operand of a 

SETA instruction), the value used for &SYSNDX is an arithmetic value. 


The following macro definitions and expansions illustrate the use of &SYSNDX. 
It is assumed that the macro instruction OUTER is the 106th macro instruction 
processed by the assembler. 
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&PARAM 
1 | A&SYSNDX 2,5 
2,5 
B&PARAM 
A&SYSNDX 


&NAME &PARAM 
&NAME 2,6 
3 | B&SYSNDX 2,6 
&PARAM 
B£PARAM 2,-F' 1000* 
5 | A&SYSNDX 2, WORD 


0300 


2,6 
2,6 

0300 

2,5 

2,5 

B0300 
А0107 
2,-F' 1000" 
2, WORD 


0400 


2,4 
26 

0400 

2,5 

2,5 

B0400 
A0109 
2,=F*1000” 
2, WORD 


Statement 6 is the 106th macro instruction to be processed in this assembly. 
Therefore, &SYSNDX is assigned the value 0106 throughout the processing of the 
macro definition for OUTER. This number replaces &SYSNDX in statement 3 and 5, 
generating the unique names B0106 and 40106. 


Statement 4 is the 107th macro instruction processed. Therefore, &SYSNDX is 
assigned the value 0107 throughout the processing of the INNER macro 
instruction. 0107 replaces &SYSNDX in statement 1 and 2, generating the 
unique name A0107. 


When the macro instruction OUTER is written again, in statement 11, the 

same model lines are processed, but because &SYSNDX now has a value of 0108, 
the symbols which name statements 4 and 5 will be unique for each 

occurrence of the same macro instruction. Note also that the presence of the 
inner macro instruction INNER does not affect the value of &SYSNDX in the 
outer macro definition. 
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@ 4.14.1.2 &SYSECT 


The system variable symbol &SYSECT may be used to represent the name of the 
control section in which a macro instruction appears. For each inner and 
outer macro instruction processed by the assembler, &SYSECT is assigned 

a value that is the name of the control section in which the macro 
instruction appears. &SYSECT may be used in model statements and in 
conditional assembly instructions. 


When &SYSECT is used in a macro definition, the value substituted for 
&SYSECT is the name of the last CSECT, DSECT, or START statement that occurs 
before the macro instruction. If no named CSECT, DSECT, or START statements 
occur before a macro instruction, &SYSECT is assigned a null character value 
for that macro instruction, i.e. no character is assigned to it. 


4 


CSECT or DSECT statements processed in a macro definition affect the value 
of &SYSECT for any subsequent inner macro instructions in that definition, 
and for any other outer and inner macro instructions. 


Throughout the processing of a macro definition, the value of &SYSECT may 

C be considered a constant for this macro level, independent of any CSECT or 
DSECT statements or inner macro instructions in that definition. &SYSECT 
will take on the name of the last CSECT, DSECT, or START statement 
regardless of whether or not that statement is correct. 


The next example illustrates these rules. 


Statement 8 is the last CSECT, DSECT, or START statement processed before 
statement 9 is processed. Therefore, &SYSECT is assigned the value 
MAINPROG for macro instruction OUTER1 in statement 9. MAINPROG is 
substituted for &SYSECT when it appears in statement 6. 


Statement 3 is the last CSECT, DSECT or START statement processed before 
statement 4 is processed. Therefore, &SYSECT is assigned the value CSOUTI1 
for macro instruction INNER in the statement 4. CSOUT1 is substituted for 
&SYSECT when it appears in statement 2. 


Statement 1 is used to generate a CSECT statement for statement 4. This is 

the last CSECT, DSECT, or START statement that appears before statement 5. 

Therefore, &SYSECT is assigned the value INA for macro instruction INNER in 
C statement 5. INA is substituted for &SYSECT when it appears in statement 2. 


Statement 1 is used to generate a CSECT statement for statement 5. This is the 
last CSECT, DSECT, or START statement that appears before statement 10. 


Therefore, &SYSECT is assigned the value INB for macro instruction OUTER2 in 
Statement 10. INB is substituted for &SYSECT when it appears in statement 7. 
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&INCSECT 


CSOUT1 


MAINPROG 


MAINPROG 


CSQUT1 


INA 


INB 


4.14.1.3 &SYSLIST 


&INCSECT 


AC&SYSECT) 


100C 

INA 

INB 
AC&SYSECT) 


AC&SYSECT) 


200C 


200C 
100C 
ACCSOUT D 


ACINA) 


ACMAINPROG) 


ACINB) 


The system variable symbol &SYSLIST provides the programmer with an 
alternative to symbolic parameters for referring to positional macro 
instruction operands. It is particularly useful when operands are supplied 
in a positional macro instruction without a corresponding symbolic parameter 
appearing in the prototype of the macro definition. 


&SYSLIST and symbolic parameters may be used in the same macro definition. 
&SYSLIST may also be used in place of symbolic parameters and follows all 
rules for concatenation with other characters that symbolic parameters 

obey. (See section 4.10, "Concatenation"). 


&SYSLIST(n) may be used to refer to the nth macro instruction operand. If the 
nth operand is a sublist, then &SYSLIST(n,m) may be used to refer to the 

mth operand in the sublist, where n and m may be any arithmetic expression 
allowed in the operand field of a SETA statement. This form of indexing may 
be extended to reference any element in an inner sublist in the same manner 


that was described for symbolic parameters. 
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If n equals zero, a null operand results. If n is greater than zero, 
the value of the macro instruction operand is given, provided that an 
operand exists corresponding to that value of n. 


The attributes of any macro instruction operand or suboperand may be 
referenced, using the &SYSLIST notation, in the same manner ‘as the 
attributes are referenced if a symbolic parameter is used. (Examples of this 
facility appear under the discussion of Attributes, section 4.15). 


. 1. 1.4 &SYSVERS 


The system symbol S SY SVERS represents the version number of the object 
program. It generates six bytes with the value 'VERxxx' (xxx = version 
number). x is a character value from 0 to 9. The value of &SYSVERS remains 
constant during assembly. This symbol is only meaningful if the source 
program to be assembled is stored in a source program library. If the source 
program is read from a file or is entered directly by way of SYSDTA, this 
system symbol cannot be evaluated. Its value in this case is as follous: 
VERAS. 


In the following example the version number of the assembled object program 
is 14. 


Using &SYSVERS 


Name Operand Comments 


&NAME 
&NAME 


VERSION VNUM Macro call 
VERSION C*VERO14’ Generated statement 


C*&SYSVERS* Macro definition 
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4.1%.1.5 &SYSDATE 


This system symbol represents the date of the translated source program. 


It generated 9 bytes with the value "mmddyynnn" (mm=month, dd=day, yy-year, 
nnn=day number of the year). 


m, d, v, and n are character values between 0 and 9. The value of the symbol 
&SYSDATE remains constant during a translation. 


In the following example, the date of the translated source program is 1⁄4 July 
1981. 


Application of &SYSDATE | 


Name Operands Comments 


&NAME 


&NAME C*&SYSDATE* Macro definition 


DATE VDATE Macro instruction 


DATE C*071481195" Generated Statement 


: 
O 


4.14.1.6 &SYSTIME 
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This system symbol represents the time of day of the assembled program. It 
generates 6 bytes with the value "hhmmss" (hh = hour, mm = minute, ss = 
second). h, m and s are character values between 0 and 9. The value of the 
time is computed at the beginning of the assembly and remains fixed during 
the assembly. 


In the following example, the time of day at the start of assembly is 
10h 34m 165. 


Application of &SYSTIME 


Name Operands Comments 


&TIME 

Macro definition 
&TIME C'&SYSTIME' 
TIME VTIME Macro instruction 
TIME DC C" 103416" Generated statement 
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C 4.14.1.7 &SYSVERM 


The £SYSVERM system symbol represents the version number of the library macro 
in which it is used. The format is "VERxxx", where xxx = version number. 
In source program macros from MLU libraries, this value is "VER", 


Application outside macros is not allowed. 


4.14.1.8 &SYSPARM 
The &SYSPARM system symbol is an eight-byte CHARACTER variable. It is 
defined in a COMOPT statement and evaluated in the macro expansion. 
Application of &SYSPARM: xCOMOPT SYSPARM-'ABCDEFG' 
© Application in the source program: &CG SETC '"&SYSPARM' 


In order to represent one apostrophe, two apostrophes must be written. 


4.14.1.9 &SYSTEM 
The &SYSTEM system symbol represents the operating system version under which 
the assembly is executed. 
It generates four bytes with the value "svvv", where 


S - 1 - BS1000 


S - 2 - BS2000 
vvv = version no. 
© Ехатр1е: 


AIF ("*&SYSTEM'(1,1) EQ 1“). B51 
AIF ('&SYSTEM'(1,1) EQ *'2').В52 
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4. 14.2 SET Symbols 


The SET symbols are a class of variable symbols whose values may be set and 
changed by the programmer both inside and outside a macro definition. SET 
symbols must be defined by the programmer before they are used. When a SET 
symbol is defined, it is assigned an initial value. SET symbols may be 
assigned new values by means of the SETA, SETB, and SETC instructions (see 
also Default Values, Appendix A.9 item 10). A SET symbol is defined when it 
appears as an operand of an LCLA, LCLB, LCLC, GBLA, GBLB, or GBLC 
instruction. A SET symbol is classified as local or global, according to 
the type of statement that is used to define it. 


4.14.2.1 Defining SET Symbols 
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SET symbols must be defined by the programmer before they are used in 
conditional and SET instructions inside or outside macro definitions. 


The LCLA, LCLB, and LCLC instructions are used to define and set initial 
values to SETA, SETB, and SETC symbols, respectively, which are to be used 
as local SET symbols. 


The GBLA, GBLB and GBLC instructions are used to define and set initial 
values to SETA, SETB, and SETC symbols, respectively, which are to be used 
as global SET symbols. 


1. LCLA, LCLB, LCLC — Define Local SET Symbols 


The format of these instructions is: 


Blank LCLA, LCLB One or more variable symbols that are to be 
or LCLC used as local SET symbols, separated by commas. 


The SETA, SETB, or SETC symbols written in the operand entry are assigned 
the initial values 0. 


If an LCLA, LCLB, or LCLC instruction appears outside macro definitions, 
then the values of the variable symbols written in the operand entry will 
be local to the source program and cannot be referenced in a macro 
definition. 


If an LCLA, LCLB, or LCLC instruction appears within a macro definition, 

then the values of the variable symbols written in the operand entry will 
be local to that macro definition and cannot be referenced in the source 

program or in any other macro definition. 


If the same variable symbol is defined as local in the source program 
and in a macro definition, or in two or more macro definitions, the 
symbol is considered to be a different SET symbol in each case. 


A variable symbol may not be used as a symbolic parameter and as a local 


SET symbol in the same definition. No SET symbols must be used that begin 
with the character sequence &SYS (see 4.14.1). 
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C All LCLA, LCLB, or LCLC instructions in a macro definition must appear 
immediately after the prototype statement and after all GBLA, GBLB, or GBLC 
instructions. All LCLA, LCLB, or LCLC instructions outside macro definitions 
in the source program must appear after all GBLA, GBLB, and GBLC 
instructions outside macro definitions, before all conditional assembly 
instructions, before all SET instructions, and before the first control 
section of the program. 


2. GBLA, GBLB, GBLC — Define Global SET Symbols 


The format of these instructions is: 


Name Operation Operand 


Blank GBLA, GBLB, One or more variable symbols that are to be 
or GBLC used as global SET symbols, separated by commas. 


The GBLA, GBLB, and GBLC instructions define global SETA, SETB, and SETC 

© symbols, respectively, and assign the same initial values as the corresponding 
types of local SET symbols. However, a global SET symbol is assigned an 
initial value by only the first GBLA, GBLB, or GBLC instruction processed 
in which the symbol appears. 
Subsequent GBLA, GBLG, or GBLC instructions processed by the assembler do not 
affect the value assigned to the SET symbol. No SET symbols must be used 
that begin with the character sequence &SYS (see 4.14.1). 


GBLA, GBLB or GBLC instructions may appear both inside and outside 
macro definitions. 


All GBLA, GBLB, and GBLC instructions in a macro definition must appear 
before all LCLA, LCLB, and LCLC instructions in that macro definition. 

All GBLA, GBLB, and GBLC instructions outside macro definitions must appear 
before all LCLA, LCLB, and LCLC instructions outside macro definitions. 


4.14.2.2 Using SET Symbols 


When a SET symbol appears in an assembly language statement inside or 
outside macro definitions, the current value of the SET symbol replaces 
the SET symbol in the statement. The resulting statement must be a valid 
assembly language statement. Variable symbols may not be used to generate 
other variable symbols, nor may SET symbols appear in a macro definition 
prototype statement. Variable symbols may be used in the operation code 
entry of a statement under the restrictions previously stated (see the 
discussion of "Model Statements", section 4.8). 


The same variable symbol may not be used as a symbolic parameter and as 
a SET symbol in the same macro definition. 
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The following example illustrates this rule. 


&NAME MOVE &TO,&FROM 


If the statement above is a prototype statement, then &NAME, £TO, and 
&FROM may not be used as SET symbols in the macro definition. 


The same variable symbol may not be used as two different types of SET 
symbols in the same macro definition. Similarly, the same variable 
symbol may not be used as two different types of SET symbols outside 
macro definitions. 


For example, if &A is a SETA symbol in macro definition, it cannot be 

used as a SETC symbol in that definition. Similarly, if &A is a SETA symbol 
outside macro definitions, it cannot be used as a SETC symbol outside 
macro definitions. 


The same variable symbol if declared local may be used in two or more 
macro definitions and outside macro definitions. If this is the case, the 
variable symbol will be considered a different variable symbol each time 
it is used. 


For example, if &A is a variable symbol (either SET symbol or symbolic 
parameter) in one macro definition it can be used as a variable symbol 
(either SET symbol or symbolic parameter) in another definition. 
Similarly, if &A is a variable symbol (SET symbol or symbolic parameter) 
in a macro definition, it can be used as a SET symbol outside macro 
definitions. 


If a local SET symbol is defined in two or more macro definitions, or in a 
macro definition and outside macro definitions, the SET symbol is considered 
to be a different SET symbol in each case. A global SET symbol, however, is 
the same SET symbol in each place it is defined. 


Global SET symbols are the only global variable symbols. Global SET 

symbols may communicate values between one or more macro definitions, 

and between macro definitions and the source program. Local SET symbols, 
however, communicate values between statements in the same macro definition, 
or between statements outside macro definitions in the source program. 


A SET symbol must be defined as a global SET symbol in each macro definition 
in which it is to be used as a global SET symbol. If it is also to be used 
as a global SET symbol outside macro definitions, it must be defined as a 
global SET symbol outside macro definition as well. 


If the same SET symbol is defined as a global SET symbol in one or more 
places, and as a local SET symbol elsewhere, it is considered the same 
symbol wherever it is defined as a global SET symbol, and a different symbol 
in each place it is defined as a local SET symbol. 


All variable SET symbols and system variable symbols may be concatenated 

with other characters. It should be noted that a period is not required 

to concatenate a SET symbol or system variable symbol with a left parenthesis, 
unless the SET symbol is defined as subscripted (see Subscripted Set Symbols, 
section 4.17.5). 
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C Variable symbols in macro instructions are replaced by the values assigned 
to them immediately prior to the start of processing the macro definition. 
If a SET symbol appears in the operand entry of a macro instruction, attri- 
bute information will not be provided. 


The (SET(A), SET(B), and SET(C) instructions may be used to change the 
values of SETA, SETB, and SETC symbols, respectively. A SET(C) statement 

may also be used to change the value of a symbolic parameter. The type 
designation, written in parentheses above, is optional. The SET instructions 
are described following the description of attribute references below. 
Attribute references may appear in all SET and conditional statements. 
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4-15 ATTRIBUTES 


The assembler assigns attributes to macro instruction operands and to 
symbols that name statements in the source program. Attribute references 
may appear only in conditional assembly and SET instructions; i.e., the 
AIF and SET instructions. 


There are six kinds of attributes. They are: type, length, scaling, integer, 
count and number. The count and number attributes may only be used within a 
macro definition. 


Each attribute has a notation associated with it. The notations are: 


Attribute: Notation: 
Type * 
Length L' 
Scaling ο 
Integer I" 
Count Κ' 
Number N* 


In a conditional statement that is outside macro definitions, an attribute 
is referenced by writing the appropriate attribute notation immediately 
followed by a symbol (e.g., T'NAME refers to the type attribute of the 
symbol NAME). 


In a conditional statement that is within a macro definition, an attribute is 
referenced by writing the appropriate attribute notation immediately 

followed by a symbolic parameter, (e.g., L'&PARAM refers to the length 
attribute of the macro instruction operand that corresponds to the symbolic 
parameter &PARAM). If the operand is a sublist, L'&PARAM(2) may be used to 
refer to the length attribute of the second element of the sublist. 


Attributes are assigned to symbols according to the following rules: 

1. The symbol must appear in the name entry of an assembly language statement 
or in the operand of an EXTRN statement in the source program. The 
statement must appear outside macro definitions. 

2. If variable symbols appear within a statement, in a field which must be 
processed to calculate an attribute, the attribute will be undefined, 


unless the statement is generated prior to the attribute reference. 


3. Attributes will be undefined for DC or DS statements which contain 
expressions in modifier fields. 


Example: 
(А+В)Х1.;*01*С1.(55С) "АС" 
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C 4. The attributes of symbols are undefined in the following cases: 
a) if the symbol names a macro-generated statement, 
b) if the symbol appears in the name entry of two or more statements 
in the source program, even if only one statement will appear in the 


assembled program, 


c) if the symbol appears as an operand or suboperand of an inner macro 
instruction, 


d) if the symbol is generated by a variable symbol, 


e) if the symbol names an EQU statement without specification of length 
or type (see 3.26.2) or an LTROG statement, 


f) if the symbol is a standard value supplied in a keyword macro 
prototype. 


If an inner macro instruction operand is a symbolic parameter, then attributes 
C of the operand are the same as the attributes of the corresponding outer 
macro instruction operand. 


If a macro instruction operand is an expression beginning with a valid symbol, 
the operand gets the attributes of this symbol. 


If a macro instruction operand is a sublist, the programmer may refer to the 
attributes of either the sublist or each operand in the sublist. The type, 
length, scaling and integer attributes of a sublist are the same as the 
corresponding attributes of the first element of the sublist. The number 

and count attributes of a sublist are discussed below. 


Each category of attribute will now be discussed in detail. 
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4.15.1 Type Attribute (T') 


The type attribute of a macro instruction operand or a symbol is a letter. 


The programmer may refer to a type attribute in the operand of SETC 
instructions or in character relations in the operands of SETB, or AIF(B) 
instructions. 


The following letters are used for symbols that name DC, DS, or DXD 
statements and for outer macro instruction operands that are symbols that 
name DC, DS, or DXD statements. 


A 


4-42 


A-type address constant, implied length, aligned to fullword 
boundary, as well as CXD. 


Binary constant. 
Character constant. 


Long floating-point constant, implied length, aligned to doubleword 
boundary. 


Short floating-point constant, implied length, aligned. 


Full-word fixed-point constant, implied length, aligned to 
fullword boundary. 


Fixed-point constant, explicit length. 


Half-word fixed-point constant, implied length, aligned to halfword 
boundary. 


Floating-point constant, explicit length. 

Floating-point constant, extended precision, implied length, aligned. 
Packed decimal constant. 

Relocatable address in an external dummy section. 

A-, S-, V-, or Y-type address constant, explicit length. 

S-type address constant, implied length, aligned. 

V-type address constant, implied length, aligned. 

Hexadecimal constant. 

Y-type address constant, implied length, aligned to halfword boundary. 


Zoned decimal constant. 
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The following letters are used for symbols (and outer macro instruction 
operands that are symbols) that name statements other than DC or DS 
statements, or that appear in the operand field of an EXTRN statement. 
I Machine instruction. 

J Control section name. 

M Macro instruction. 


Τ External svmbol. 


The following letters are used for inner and outer macro instruction 
operands onlv. 


N Self-defining term, SETA and SETB variable 

0 Omitted operand. 

The letter U (undefined) is used for inner and outer macro instruction 
operands that cannot be assigned any of the above letters, such as literals 
or character strings, for all system symbols and SETC variables. The letter U 
is also assigned to ordinary symbols in the case outlined in Attribute 


Rule 4 above. 


The type attribute of macro instruction operands that are generated by 
symbolic parameters other than variable symbols is U. 


The type attributes of all operands in the following examples are undefined: 


Outer macro CALL 1 "BOY" ,E(F=G) , ABCDEFGHI , -ACO) 
Instruction 

Inner Macro CALL2 CAT 

Instruction 


The attributes in the following examples will be defined only if the 
statements are defined prior to a reference to the attribute. 


A DC &Х.12*1' where &X is a character variable symbol. 


B DC &B.F'01"' where &B is an arithmetic variable symbol. 
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4.15.2 Length (I.“), Scaling (5'), and Integer (I') Attributes 


The length, scaling, and integer attributes of macro instruction operands 
and symbols are numeric values. The length attribute of a symbol (or a macro 
instruction operand that is a symbol) is as described in section 3.8 of this 
publication. The length attribute of a symbol or macro instruction operand 
whose type attribute is M, O or U is zero. If the type attribute is N or T, 
the length attribute is one. 


Exception: 


Any length may be specified for EQU statements in extended format (see 
3.26.2). 


Scaling and integer attributes are provided for symbols that name fixed- 
point, floating-point, and decimal DC or DS statements. 


Fixed and Floating Point: The scaling attribute of a fixed point or 
floating point number is the value given by the scale modifier. The integer 
attribute is a function of the scale and length attributes of the number. 


Decimal: The scaling attribute of a decimal number is the number of 
decimal digits to the right of the decimal point. The integer attribute of 
a decimal number is the number of decimal digits to the left of the decimal 
point. 


Scaling and integer attributes are available for symbols and macro 
instruction operands only if their type attributes are H, F, and G 
(fixed-point); D, E, and K (floating-point); or P and Z (decimal). 


The programmer may refer to the length, scaling, and integer attributes in 
the operand field of a SETA instruction, or in arithmetic relations in the 
operand fields of SETB or AIF instructions. 


4.15.3 Count Attribute (K') 


The programmer may refer to the count attribute of macro instruction operands 
and to the count attribute of SETA, SETB and SETC variables and system 
symbols. 


The count attribute of macro instruction operands is a value equal to the 
number of characters in the macro instruction operand after substitution 
for variable symbols. If the operand is a sublist, the count attribute 
includes the beginning and ending parentheses and the commas within the 
sublist. The count attribute of any suboperand of any level sublist may be 
referenced. The count attribute of an omitted operand is zero. 


If a macro instruction operand contains variable symbols, the characters 


that replace the variable symbols, rather than the variable symbols, are 
used to determine the count attribute. 
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The count attribute for system symbols and SET variables: 


&SYSDATE 9 

&SYSTIME 6 

&SYSTEM e 

&SYSVERS 6 

&SYSVERM 6 

&SYSNDX % 

&SYSPARM Number of characters from corresponding COMOPT option 
(up to 8) 

&SYSECT Number of characters that the name in the variable &SYSECT has 
(up to 8) 


SETA variable Number of characters required to indicate the current number 
value of the SET symbol as a decimal number, without 
leading zeros. 


E.g. &АБ1 SETA 111  K'AGl-3 
&AG2 SETA X'FF' K'AG2-3 


SETB variable Constant value 1 
SETC variable Number of character containing the variable 


The programmer may refer to the count attribute in the operand field of a 
SETA instruction , ot in arithmetic relations in the operand fields of 
SETB and AIF instructions. 


4.15.4 Number Attribute (N') 


The programmer may refer to the number attribute of macro instruction 
operands only. 


The number attribute is a value equal to the number of operands in the 
operand list (&SYSLIST) or in an operand sublist. The number of operands 
in an operand sublist is equal to one plus the number of commas that 
indicate the end of an operand in the sublist. The number attribute 

of any nested sublist may be referenced. 


If the macro instruction operand is not &SYSLIST and not a sublist, the 
number attribute is one. If the macro instruction operand is omitted, the 
number attribute is zero. 
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The following examples illustrate the N' and K' attributes for various macro ә 
instruction operands within the sublist corresponding to the symbolic 
parameter &P. 


Operand Value: Ν' κ' 
&P (А, (A, B), CC, (D, E)), 6) 5 22 
&P(1) A 1 1 
&P( 2) (A,B) 2 5 
&P(3) (C,(D,E)) 2 9 
&P(4) G 1 1 
&P(5) NULL 0 0 
&P(2,2) B 1 1 
&P(3,2) (D,E) 2 5 
&P(3,2,1) D 1 1 
&P(1,1) A 1 1 
&P(2,3) NULL 0 0 
&SYSLIST A,B,C 3 Ν/Α 


The programmer mav refer to the number attribute in the operand field of a 
SETA instruction, or in arithmetic relations in the operand fields of Ə 
SETB and AIF instructions that are part of a macro definition. 
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- 4.16 ASSIGNING INTEGER ATTRIBUTES TO SYMBOLS 


The integer attribute is computed from the length and scaling attributes. 


Fixed-Point: The integer attribute of a fixed-point number is equal to 
eight times the length attribute of the number minus the scaling 
attribute minus опе; i.e., I'-8xL'-S'-]. 


Each of the following statements defines a fixed-point field. The length 
attribute of HALFCON is 2, the scaling attribute is 6, and the integer 
attribute is 9. The length attribute of ONECON is 4, the scaling attribute 
is 8, and the integer attribute is 23. 


Name Operation Operand 


HALFCON DC HS6' -25. 93" 
C ONECON DC FS8* 100. 3E-2" 


Floating Point: The integer attribute of a floating-point number is equal 
to two times the difference between the length attribute of the number and 
one, minus the scaling attribute; i.e., I'-2x(L'-1)-S'. 


EAch of the following statements defines a floating-point value. The length 
attribute of SHORT is 4, the scaling attribute is 2, and the integer 
attribute is 4. The length attribute of LONG is 8, the scaling attribute 

is 5, and the integer attribute is 9. 


SHORT DC ES2'466.415"' 
LONG DC DS5' -3.729*' 


C Decimal: The integer attribute of a packed decimal number is equal to 
two times the length attribute of the number minus the scaling attribute 
minus опе; i.e. I'-2xL|'-S'-]1l. The integer attribute of a zoned decimal 
number is equal to the difference between the length attribute and the 
scaling attribute; i.e., I'-L'-S'. 


Each of the following statements defines a decimal field. The length 
attribute of FIRST is 2, the scaling attribute is 2, and the integer 
attribute is 1l. The length attribute of SECOND is 3, the scaling attribute 
is 0, and the integer attribute is 3. The length attribute of THIRD is 4, 
the scaling attribute is 2, and the integer attribute is 2. The length 
attribute of FOURTH is 3, the scaling attribute is 2, and the integer 
attribute is 3. 


FIRST DC Ppl: 25" 
SECOND DC Z' -543' 

THIRD DC Z* 79.68" 
FOURTH DC P'79.68* 
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4.17 SET INSTRUCTIONS 


4.17.1 SETA — Set Arithmetic 


The SETA (or SET) instruction may be used to assign an arithmetic value to 
a SETA symbol. The value of the SETA variable symbol may be changed by a 
subsequent SETA statement. 


The format of this instruction is? 


A SETA SETA, or SET An arithmetic expression 
symbol 


The expression in the operand entry is evaluated as a signed 32-bit 
arithmetic value which is assigned to the SETA symbol in the name entry. 
The minimum and maximum allowable values of the expression are ; 
-2?! and +23! -1, respectively. 


The expression may consist of one term or an arithmetic combination of terms. 
The terms that may be used are self-defining terms, variable symbols, 
character values, and the length, scaling, integer, count and number 
attributes. 


Furthermore, the value may be an empty string, e.g. the value of an 
unoccupied macro operand. An empty string is interpreted as zero. 


Notes: 


— A SETC variable symbol or character value may be used as a term in a 
SETA expression if the value is from 1 to 8 decimal digits. A symbolic 
parameter may be used if its value is a decimal, hexadecimal or binary 
self-defining term. 


— The arithmetic operators that may be used to combine the terms of an 
expression are * (addition), - (subtraction), * (multiplication), and 
/ (division). 

— An expression may not contain two terms or two dyadic operators in 
succession. The monadic operators + and - may appear before any term 
and at the beginning of an expression. 


The following are valid operand fields at SETA instructions: 


SAREA+X* 2D" I'&N/25 


&BETAx10 &EXIT-S'&ENTRY*1 
L'&HERE+32 29 

&Q+' 10' 

*(-20*-10) 
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@ The following are invalid operand fields of SETA instructions: 
&AREAX'C* (two terms in succession) 
&FIELD+* (two operators in succession) 
-&DELTAx2 (begins with an operator) 
x32 (begins with an operator; two operators in succession) 
NAME/ 15 (NAME is not a valid term) 


4.17.1.1 Evaluation of Arithmetic Expressions 


The procedure used to evaluate the arithmetic expression in the operand 
of a SETA instruction is the same as that used to evaluate arithmetic 
expressions in assembly language statements. The only difference betueen 
the two types of arithmetic expressions is the terms that are allowed in 
each expression. 


© The following evaluation procedure is used: 
1. Each term is given its numerical value. 


2. The arithmetic operations are performed moving from left to right. 
However, multiplication and/or division are performed before addition 
and subtraction. 


3. The computed result is the value assigned to the SETA symbol in the 
name entry. 


The arithmetic expression in the operand entry of a SETA instruction may 
contain one or more sequences of arithmetically combined terms that are 
enclosed in parentheses. A sequence of parenthesized terms may appear 
within another parenthesized sequence. The following are examples of SETA 
instruction operands that contain parenthesized sequences of terms. 


(L'&HERE*32) x29 
&AREA*X' 2D'/C&EXIT-S'&ENTRY-* 1) 
&BETAXx10x(I'£N/25/(&EXIT-S'&ENTRY-* 1) ) 


The parenthesized portion or portions of an arithmetic expression are 

ç evaluated before the rest of the terms in the expression are evaluated. 
If a sequence of parenthesized terms appears within another parenthesized 
sequence, the innermost sequence is evaluated first. 


As the SETA expression is scanned, a counter is incremented bv one for each 
term that is recognized. When an arithmetic operation is possible, 

according to the operator precedence rules, it is performed, and the counter 
is decremented bv one. The process continues until the expression has been 
completelv evaluated or until the counter exceeds four. 
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4.17.1.2 Using Local SETA Symbols 


The arithmetic value assigned to a SETA symbol is substituted for the SETA 
symbol when it is used in an arithmetic relation. If the SETA symbol 

is not used in an arithmetic expression, the arithmetic value is 
completely converted to an unsigned integer, with leading zeros removed. 
If the value is zero, it is converted to a single zero. 


The following example illustrates this rule: 


&TO,&FROM 
£A,&B,£C,£D 


T QI м н 


2, SAVEAREA 
2, &FROM&C 
2,£TO£D 

2, SAVEAREA 


ο ul 


FIELDA,FIELDB 


2, SAVEAREA 
2,FIELDB2 
2,FIELDA8 
2, SAVEAREA 


Statements 1 and 2 assign to the SETA symbols &A and &B the arithmetic values 
*10 and *12, respectively. Therefore, statement 3 assigns the SETA symbol &C 
the arithmetic value -2. When &C is used in statement 5, the arithmetic 

value -2 is converted to the unsigned integer 2. When &C is used in 

statement 4, however, the arithmetic value -2 is used. Therefore, &D is 
assigned the arithmetic value +8. When &D is used in statement 6, the 
arithmetic value *8 is converted to the unsigned integer 8. 
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S The following example shows how the value assigned to a SETA symbol may be 
changed in a macro definition. 


&TO,&FROM 

£A 

5 

2, SAVEAREA 
2,&FROMEA 

8 

2,£TO£A 

2, SAVEAREA 


Operand 
FIELDA,FIELDB 


2, SAVEAREA 
2,FIELDB5 
2,FIELDA8 
2, SAVEAREA 


Statement 1 assigns the arithmetic value +5 to SETA symbol ΣΑ. In statement 
2, ΣΑ is converted to the unsigned integer 5. Statement 3 assigns the 
arithmetic value +8 to £A. In statement 4, therefore, &A is converted to 
the unsigned integer 8, instead of 5. 


A SETA symbol or SETA arithmetic expression may be used with a symbolic 
parameter to refer to an operand in a sublist. 
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The following macro definition may be used to add the last operand in an ә 
орегапа sublist to the first operand in a sublist and store the result 

at the first operand. A sample macro instruction and generated statements 

follow the macro definition. 


1 &NUMBER,&REG 
&LAST 
2 | £LAST N'&NUMBER 
REG, SNUMBER( 1) 
3 REG, £NUMBER(&LAST) 
REG, SNUMBER( 1) 
L 3, 
A 3,E ә 
ST 3,A 


&NUMBER is the first symbolic parameter in the operand entry of the prototype 
statement (statement 1). The corresponding characters, (A,B,C,D,E), of the 
macro instruction (statement 4) are a sublist. Statement 2 assigns to &LAST 
the arithmetic value *5, which is equal to the number of operands in the 
sublist. 


Therefore, in statement 3, &NUMBER(&LAST) is replaced by the fifth operand 
of the sublist. 


A SETA symbol or SETA arithmetic expression may be used with &SYSLIST 
to refer to positional macro operands, as illustrated after the discussion 
of the MEXIT instruction. 


SETA symbols used as global variable symbols are illustrated in a subsequent 
section entitled "Using Global SET Symbols" (see section 4.17.4). 
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ç &. 17.2 SETC - SET Character 


The SETC (or SET) instruction is used to assign a character value to a 
SETC symbol, to change a previously assigned value, or to change the 
the value of a symbolic parameter. 


The format of this instruction is: 


A SETC SETC One operand, of the form described below 
symbol or 
symbolic 
parameter 


The operand may consist of the type attribute, a character value, a 
substring notation, or a concatenation of substring notations and character 
expressions. Variable symbols may appear in the operand field of a SETC 

© statement. If a SETA or SETB symbol is used in a SETC statement, the result 
is the character representation of the decimal or boolean value, respectively, 
unsigned, with leading zeros removed. If the value is zero, one decimal zero 
is used. 


The terms allowed in a SETC instruction are described below. 


4.17.2.1 Type Attribute 


The character value assigned to a SETC symbol or symbolic parameter may be 
a type attribute. If the type attribute is used, it must appear alone 

in the operand field. The following example assigns to the SETC symbol 
&TYPE the letter that is the type attribute of the macro instruction 
operand that corresponds to the symbolic parameter &АВС. 


C Name Operation Operand 


&TYPE SETC T'&ABC 


4.17.2.2 Character Value 


A character value or expression consists of any combination of characters 
enclosed in apostrophes and preceded by a duplication factor, if required. 
The duplication factor is an arithmetic expression that may be used as an 
operand in a SETA instruction. It is enclosed in parentheses. A SETC 
symbol or symbolic parameter can be assigned a character value of not 

more than 127 characters after execution of the duplication factor. 
Intermediate values of character expressions from which the final value 

is extracted may be up to 255 characters. Concatenation also permits up to 
255 characters to be assigned. 


Example of a character expression with duplication factor: 


C (3)'A' produces "ААА" 
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&.17.2.3 Evaluation of Character Expressions 


4-56 


The following statement assigns the character value ABX4 to the SETC 
symbol &ALPHA: 


Name Operation Operand 


&ALPHA SETC ' ABXG' 


More than one character expression may be concatenated into a single 
character expression by placing a period betueen the terminating apostrophe 
of one character expression and the opening apostrophe of the next 
character expression. For example, either of the following statements may 
be used to assign the character value ABCDEF to the SETC symbol &BETA. 


&BETA SETC "ABCDEF' 
&BETA SETC "ABC". "DEF" 


Two apostrophes must be used to represent an apostrophe that is part of a 
character expression. 


The following statement assigns the character value L'SYMBOL to the SETC 
symbol &LENGTH. 


Name Operation Operand 


&LENGTH SETC "L"SYMBOL' 


Variable symbols may be concatenated with other characters in the operand 
field of a SETC instruction according to the general rules for 
concatenating variable symbols with other characters. 


If &ALPHA has been assigned the character value ABX4, the following 
statements may be used to assign the character value ABX%4RST to the 
variable symbol &GAMMA. 


Name Operation Operand 


&GAMMA SETC "&ALPHA. RST” 


or 
Name Operation Operand 
&GAMMA SETC ALPHA“. RST“ 


Two ampersands must be used to represent an ampersand that is not part 
Of a variable symbol. Both ampersands become part of the character 
value assigned to the SETC symbol. They are not replaced by a single 
ampersand. 
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S The following statement assigns the character value HALF&& to the SETC 
symbol £AND. 


Name Operation Operand 


&AND SETC *"HALF&&* 


In this example, 


Name Operation Operand 


RA SETC "&&BETA" (2,5) 


'&&BETA'(2,5) produces &BETA which is considered a character string, not a 
variable symbol. 


6, 17. 2. 4 Substring Notation 


The value assigned to a SETC symbol or symbolic parameter may be a substring. 
Substring character values permit the programmer to assigns part of a 
character value to a variable symbol. 


If the programmer wants to assign part of a character value to a SETC 
symbol, he must indicate to the assembler in the operand of a SETC 
instruction: 


1. the character value itself, and 


2. the part of the character value he wants to assign to the SETC symbol 
or symbolic parameter. 


The concatenation of 1. and 2. in the operand of a SETC instruction is 
called a substring notation. The character value that is assigned to the 
C variable symbol name entry is called a substring character value. 


Substring notation consists of a character expression, immediately followed 
by tuo arithmetic expressions that are separated from each other by a comma 
and are enclosed in parentheses. The two arithmetic expressions may be any 
expression that is allowed in the operand of a SETA instruction, with the 
restriction that character values are not permitted. 


The first expression indicates the first character (in the character 
expression) that is to be assigned to the SETC symbol or symbolic parameter 
in the name entry of the SETC statement. The second expression indicates 

the number of consecutive characters in the character expression (starting 
with the character indicated by the first expression) that are to be assigned 
to the SETC symbol. If a substring specifies more characters than are in the 
character string, the number of available characters will be supplied. 


The maximum size character expression from which the substring character 
value can be chosen, is 255 characters. 
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A duplication factor can be applied to a substring. In a substring notation, 
first the substring is evaluated and then the duplication factor is executed. 


Example: 
(2)'ABC'(3,1) produces CC 


The following are valid substring notations: 


ALPHA“ (2,5) 

ARX AH (&AREA*2, 1) 

'&ALPHA' . * RST' C6,&A) 

" ABC&GAMMA' (SA, &AREA*2) 

(ZA) '&ALPHA' (CB, XC) where £&A,&B,&C are arithmetic expressions. 


The following are invalid substring notations: 


'&BETA' (4,6) (blanks between character value and arithmetic 
expressions) 

т" *SYMBOL* ( 142-&ХҮ2) (only one arithmetic expression) 

*ABX48ALPHA® C&S&FIELDX2) (arithmetic expression not separated by a comma) 

BETA“ A, 6 (arithmetic expressions not enclosed in 
parentheses) 

"&ALPHA' (2,4) (1, 1) (double substring notation is not permitted) 


4-56 Assembler V29.1C, U62-J-255-6-7600 


SET instructions 
@ &.17.2.5 Concatenating Substring Notations and Character Expressions 


Substring notations may be concatenated with character expressions in the 
operand of a SETC instruction. If a substring notation follows a character 
expression, the two may be concatenated by placing a period between the 
terminating apostrophe of the character expression and the opening apostrophe 
of the substring notation. 


For example, if &ALPHA has been assigned the character value ABX4, and &BETA 
has been assigned the character value ABCDEF, then the following statement 
assigns &GAMMA the character value ABX4BCD. 


Name Operation Operand 


&GAMMA SETC ALPHA“. '&£BETA'C2,3) 


If a substring notation precedes a character expression or another substring 
notation, the two may be concatenated by writing a period immediately 

© after the closing parenthesis of the substring notation. The period тау, 
however, be omitted if the character expression following the substring 
notation does not begin with a duplication factor. 


If &ALPHA has been assigned the character value AB%4, and &ABC has been 
assigned the character value 5RS, either of the following statements may 
be used to assign &WORD the character value ABX45RS. 


SWORD SETC Σ5ΑΙ ΡΗΑ" (1,4) "&АВС" 
&WORD SETC ALPHA“ (1,4) '&ABC' (1, 3) 


If a SETC symbol is used in the operand of a SETA instruction, the 

character value assigned to the SETC symbol must be one to eight decimal 

digits. 

If a SETA symbol is used in the operand of a SETC statement, the arithmetic 
C value is converted to a single zero. If a SETB symbol is used in the binary 


operand of a SETC statement, the value is converted to the character 
representation of one or zero. 
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4.17.2.6 Using Local SETC Symbols 


The character value assigned to a SETC symbol or symbolic parameter is 
substituted for that variable symbol when it is used in the name, operation, 
or operand of a statement. 


For example, consider the following macro definition, macro instruction, 
and generated statements. 


&NAME 


&TO,&FROM 
&PREFIX 
'£TO'(1,4) 

2, SAVEAREA 

2, &PREFIX&FROM 
2,&TO 

2, SAVEAREA 


&PREFIX 
&NAME 


FIELDA,B 


2, SAVEAREA 
2,FIELDB 
2,FIELDA 
2, SAVEAREA 


Statement 1 assigns the substring character value FIELD (the first five 
characters corresponding to symbolic parameter &TO) to the SETC symbol 
&PREFIX . Therefore, FIELD replaces &PREFIX in statement 2. 


Examples of the use of the SETC instruction to change the value of a symbolic 
parameter appear in a later section of this manual. 


4.17.3 SETB — SET Binary 


4-58 


The SETB instruction may be used to assign the binary value 0 or 1 to a 
SETB symbol. 


The format of this instruction is: 


A SETB SETB or А Ü ог a 1, (0) or (1), or a logical expression 
symbol SET enclosed in parentheses 


The operand may contain a O or a 1 or a logical expression enclosed in 
parentheses. A logical expression is evaluated to determine if it is true 
or false; the SETB symbol in the name entry is then assigned the binary 
value 1 or 0 corresponding to true or false, respectively. 
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@ A logical expression consists of one term or a logical combination of terms. 
The terms that may be used alone or in combination with each other are 
arithmetic relations, character relations, and SETB symbols. 


The logical operators used to combine the terms of an expression are AND, 
OR, and NOT. The NOT operator must be preceded by AND or OR, unless it is 
the first operator of a logical expression. 


A logical expression may not contain two terms in succession. A logical 
expression may contain two operators in succession only if the first 
operator is either AND or OR, and the second operator is NOT. A logical 
expression may begin with the operator NOT. It may not begin with the 
operators AND or OR. 


An arithmetic relation consists of two arithmetic expressions, or an 
arithmetic and a character expression connected by a relational operator. 
The relational operators are EQ (equal), NE (not equal), LT (less than), 
GT (greater than, LE (less than or equal), and GE (greater than or 
equal). Any expression that is permissible in the operand of a SETA 
instruction, may be used as an arithmetic expression in the SETB operand 
entry, including SETA symbols, symbolic parameters, and character values, 
© under the restrictions previously discussed. 


A character relation consists of two character values connected by a 
relational operator. Anything that may be used in the operand of a SETC 
instruction may be used as a character value in the operand of a SETB 
instruction. It is necessary to enclose SETC symbols, &SYSECT, &SYSLIST, 
or symbolic parameters in quotes when they are used in character 
relations. 


The type of expressions and terms that are used in a relation determines 

the nature of the comparison used to evaluate it. A logical relation results 
when all terms are considered to be character; that is, all terms are 

valid operands of SETC instructions, SETC symbols, the system variable 
symbols &SYSECT or &SYSLIST, or symbolic parameters. In all other cases, 

an arithmetic relation results. 


The following examples illustrate these rules. &CG4 and &CG2 are character 
variable symbols. &AL4, &AL10, £AG1 and &AG3 are arithmetic variable symbols. 
&AREA is a symbolic parameter. 


Type of Relation 

ç (*FIELD* NE *&CG4") Character 

('*FIELD' NE &CG4) Character 

(&А14 GT &AG1) Arithmetic 

(SAL4¢ GT "&А61°) Arithmetic 

(&CG4 LE &CG2) Character 

('*&CG2.X9' EQ BOY) Character 

(&AL10-&AL4XxX7 LT 16%8AG3+4) Arithmetic 

(&AL10 EQ '&CG2'(5,&A61)) Arithmetic 

(&AREA*2 GT 29) Arithmetic 


(&AREA EQ &CG4) Character 


The maximum size character values that can be compared is 127 characters. 
If the two character values are of unequal length, then the shorter one will 
always compare less than the longer one, regardless of the characters present. 


The relational and logical operators must be immediately preceded and 
followed by at least one blank or other special character. Each relation 
may or may not be enclosed in parentheses. If a relation is not enclosed in 
parentheses, it must be separated from the logical operators by at least 
one blank or other special character. 
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A relation enclosed in parentheses need not be separated from the 
parentheses by any blanks. 


The following are valid operand fields of SETB instructions: 


(&AREA*2 GT 29) 

('*ABX6' EQ '&ALPHA') 

(T'&ABC NE T'&XYZ) 

(T'&P1l2 EQ 'F*) 

(&АКЕА+2 GT 29 OR &B) 

(NOT &B AND &AREA*X'2D' GT 29) 
(*&C "EQ" МВ") 


The following are invalid operand fields of SETB instructions: 


&B (not enclosed in parentheses) 

(T'&P12 EQ "Е" &B) (tuo terms in succession) 

("ABX4' EQ "ALPHA" NOT &B) (the NOT operator must be preceded by AND or OR) 
(AND T'&P12 EQ 'F*) (expression begins with AND) 


4.17.3.1 Evaluation of Logical Expressions 
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The following procedure is used to evaluate a logical expression in the 
operand field of a SETB instruction: 


1. Each term (i.e., arithmetic relation, character relation, or SETB symbol) 
is evaluated and given its logical value (true or false). If an arithmetic 
term is combined in a relation, the character term will be converted to 
its arithmetic value before the relation is evaluated. If the character 
term does not contain only decimal characters, its arithmetic value is 
zero. 


2. The logical operations are performed moving from left to right. However, 
NOTs are performed before ANDs, and ANDs are performed before ORs. 


3. The computed result is the value assigned to the SETB symbol in the name 
field. 


The logical expression in the operand of a SETB instruction may contain one 
or more sequences of logically combined terms that are enclosed in 
parentheses. Α sequence of parenthesized terms may appear within another 
parenthesized sequence. 


The following are examples of SETB instruction operands that contain 
parenthesized sequences of terms. 


(NOT(&B AND &AREA*X'2D' GT 29) 
(&B AND (T'P12 EQ F“) OR &B) 


The parenthesized portion or portions of a logical expression are evaluated 
before the rest of the terms in the expression are evaluated. If a sequence 
of parenthesized terms appears within another parenthesized sequence, the 
innermost sequence is evaluated first. 


A maximum of 8 levels of parentheses are permitted. 


Logical expressions follow the rule that was given for arithmetic expressions 
for calculating the maximum number of permissible terms. 
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The logical value assigned to the SETB symbol is substituted for the SETB 
symbol when it appears in the operand of an AIF instruction or another SETB 
instruction. 


If a SETB symbol is used in the operand of a SETA instruction, or in 
arithmetic relations in the operands of AIF and SETB instructions, the 
binary values 1 (true) and 0 (false) are converted to the arithmetic values 
+1 and +0, respectivelv. 


The following example illustrates these rules. 


&TO,&FROM 
&A1 
&B1,2B2 
&C1 

(L'£TO EQ4) 
(S'£TO EQO) 
&B1 

'&B2' 

2, SAVEAREA 
2, &FROM&A1 
2,2T08C1 

2, SAVEAREA 


T+ GQ [N + 


FIELDA F*01" 
FIELDB DS3' 12° 
HERE FIELDA,FIELDB 


2, SAVEAREA 
2,FIELDB1 
2,FIELDAO 
2, SAVEAREA 


ç Because the operand of statement 1 is true, &B1 is assigned the binary value 
1. Therefore, the arithmetic value +1 is substituted for &B1 in statement 3. 
Because the operand of statement 2 is false, &B2 is assigned the binary 
value 0. Therefore, the character value 0 is substituted for &B2 in statement 
4. 


The use of global SETB variable symbols is illustrated below. 
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6. 17.4 Using Global SET Symbols 
The examples in the previous discussion of the SET instructions used local 
variable symbols onlv. 
The following examples illustrate the use of global and local SET symbols. 
Each example consists of two parts. The first part is an assemblv language 
source program. The second part shows the statements that would be generated 
by the assembler after it processed the statements in the source program. 
Example_ 1: 
This example illustrates how the same SET symbol can be used to communicate: 
1. values betueen statements in the same macro definitions, and 


2. different values between statements outside macro definitions. 


&A 
15,&A 
&A+1 
&A 
15,&A 


15;&A 
FIRST 


FIRST LR 15,0 
LR 15,0 
LR 15,0 
LR 15,0 
END FIRST 


&A is defined as a local SETA symbol in a macro definition (statement 1) 
and outside macro definitions (statement 4). ΣΑ is used twice within macro 


definition (statement 2 and 3) and twice outside macro definitions (statement 
5 and 6). 


Since &A is a local SETA symbol in the macro definition and outside macro 
definitions, it is one SETA symbol in the macro definition, and another SETA 
symbol outside macro definitions. Therefore, statement 3 (which is in the 
macro definition) does not affect the value used for &A in statement 5 and 

6 (which are outside macro definitions). 
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@ Example 2: 
This example illustrates how the same SET symbol can be used to communicate: 
1. values betueen statements in one macro definition, and 
2. different values between statements in a different macro definition. 


&A is defined as a local SETA symbol in two different macro definitions 
(statements 1 and 4). ΣΑ is used twice within each macro definition 
(statements 2, 3, 5 and 6). 


Since £A is a local SETA symbol in each macro definition, it is one SETA 
symbol in one macro definition, and another SETA symbol in the other macro 
definition. Therefore, statement 3 (which is in one macro definition) does 
not affect the value used for &A in statement 5 (which is in the other macro 
definition). Similarly, statement 6 does not affect the value used for &A 

in statement 2. 


SA 
15, KA 
&A+1 


&A 
15,&A 
&A+1 


© FIRST LR 15,0 
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Example 3j: 


This example illustrates how a SET symbol can be used to communicate values 


between statements that are part of two different macro definitions. 


FIRST LR 


&A is defined as a global SETA symbol in two different macro definitions 
(statements 1 and 4). &A is used twice within each macro definition (statement 


2, 3, 5 and 6). 


Since &A is a global SETA symbol in each macro definition, it is the same 
SETA symbol in each macro definition. Therefore, statement 3 (which is in 
one macro definition) affects the value for &A in statement 5(which is in the 
other macro definition). Similarly, statement 6 affects the value used for &A 


in statement 2. 
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SA 
15,8A 
&A+1 


&A 
15,&A 
&A+1 


FIRST 


15,0 
15,1 
15,2 
15,3 
FIRST 
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Example 4: 


This example illustrates how the same SET symbol can be used to communicate: 
1. values between statements in two different macro definitions, and 
2. different values between statements outside macro definitions. 


&A is defined as a global SETA symbol in two different macro definitions 
(statements 1 and 4), but it is defined as a local SETA symbol outside macro 
definitions (statement 7). ΣΑ is used twice within each macro definition апа 
twice outside macro definitions (statements 2, 3, 5, 6, 8 and 9). 


ΣΑ 
15 f 
&A+1 


&A 
15,&A 
&A+1 


&A 
15,8A 


15,8Α 
FIRST 


15,0 
15,1 
15,0 
15,2 
15,3 
15,0 
FIRST 


Since &A is a global SETA symbol in each macro definition, it is the same SETA 
symbol in each macro definition. However, since &A is a local SETA symbol 
outside macro definitions, it is a different SETA symbol outside macro 
definitions. 


Therefore, statement 3 (which is in one macro definition) affects the value 
used for &A in statement 5 (which is in the other macro definition), but it 
does not affect the value used for &A in statements 8 and 9 (which are 
outside macro definitions). Similarly, statement 6 affects the value used for 
ΣΑ in statement 2, but it does not affect the value used for ΣΑ in statement 
8 and 9. 
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Example 5: 


The next example illustrates the use of a global character variable 

symbol in conjunction with the system variable symbol &SYSNDX, to communicate 
between an inner and outer macro definition. OUTER] is assumed to be the 
106th macro instruction processed in the program. 


&NDXNUM 
1 | A&SYSNDX 2,5 
2,5 
B&NDXNUM 
A&SYSNDX 


&NDXNUM 
' SYSNDX' 
2,4 
2,6 


2,=F* 1000” 


ο N 


A0109 
2,=F* 1000" 


Statement 5 is the 107th macro instruction processed. Therefore, &SYSNDX 
is assigned the number 0107 for that macro instruction. The number 0107 is 
substituted for &SYSNDX when it is used in statements 1 and 3. The number 
0106 is substituted for the global SETC symbol &NDXNUM in statement 2. 


Statement 8 is the 108th macro instruction processed. Therefore, each 
occurrence of &SYSNDX is replaced by the number 0108. For example, statement 
6 is used to create the unique name B0108. 


When statement 5 is used to process the 108th macro instruction, statement 5 
becomes the 109th macro instruction processed. Therefore, each occurrence 

of &SYSNDX is replaced by the number 0109. For example, statement 1 is used 
to create the unique name A0109. 
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Global SETB and SETC variable symbols are used in the following example to 
generate operation codes, symbols, and literals. 


Name 


&NAME 


&CGl 
ΣΑΙ 1 
&BG8 
&DUP 
&NAME 


CON1 
CON2 
BEGIN 


CON2 
CON1 


CON? 
BEGIN 


Operand 


&A,&B 

&DUP 

&BG8 

&CG1 

&AL1 

T&A 

L'&A 

(&B EQ") 

&AL 1x4 

ΣΑ. (&AL1) , -&CG1' 01" 
FIELD&BG8(&AL1) ,&A 


РЕЗ" 12" 

Н" 04" 
CON1,SWTCH 
CON2 

Н" 04" 
BEGIN 


rir 22 

H* 04" 

CON1(3) ,=P*01" 
FIELDO(3) , CON1 
CON2(2) , H'01' 
FIELD1(2) ,CON2 
BEGIN 


Assembler V29.1C, U62-J-255-6-7600 


4-67 


SET instructions 


4.17.5 Subscripted SET Symbols 


Both global and local SET symbols may be defined as subscripted SET symbols 
inside and outside macro definitions. All SET symbols defined in the 
previous sections of this document are nonsubscripted SET symbols. 


Subscripted SET symbols provide the programmer with a convenient way to use 
one SET symbol plus a subscript to refer to many arithmetic, binary, or 
character values. 


A subscripted SET symbol consists of a SET symbol immediately followed by a 
subscript that is enclosed in parentheses. The subscript may be any arithmetic 
expression that is allowed in the operand of a SETA statement in the range 

of 1 to the specified dimension. 


The following are valid subscripted SET symbols: 


&READER( 17) 
&A23656(&S4) 
&X6F2(25*&A2) 


The following are invalid subscripted SET symbols: 


&X^4F2 (no subscript) 
( 25) (no SET symbol) 
&X4F 2025) (subscript does not immediately follow SET symbol) 


4.17.5.1 Defining Subscripted SET Symbols 


If the programmer wants to use a subscripted SET symbol, he must write the 
SET symbol in a GBLA, GBLB, GBLC, LCLA, LCLB, or LCLC instruction, 
immediately followed by an unsigned decimal integer enclosed in parentheses. 
The decimal integer, called a dimension, indicates the number of SET 
variables associated with the SET symbol. Every variable associated with a 
SET symbol is assigned an initial value that is the same as the initial 
value assigned to the corresponding type of nonsubscripted SET symbol. 


If a subscripted SET symbol is defined as global, the same dimension must be 
used with the SET symbol each time it is defined as global. 


The maximum dimension that can be used with a SETA, SETB, or SETC symbol 
is 2500. Dimension 1 is not permitted. 


A subscripted SET symbol may be used only if the declaration was subscripted. 
A nonsubscripted SET symbol may be used only if the declaration had no 
subscript. 


A period is not required after a nonsubscripted SET symbol for concatenation 
with a left parenthesis. 
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çS The following statements define the global SET symbols &SBOX, &WOBOX, and 
&PSW, and the local SET symbol &TSW. &SBOX has 50 arithmetic variables 
associated with it. &WBOX has 20 character variables, &PSW and &TSW 
each have 230 binary variables. 


&SBOX(50) 
&WBOX( 20) 
&PSW( 230) 
&TSW( 230) 


4.17.5.2 Using Subscripted SET Symbols 


After the programmer has associated a number of SET variables with a SET 
C symbol, he may assign values to each of the variables and use them in other 
statements. 


If the statement in the previous example were part of a macro definition, 
(and &A was defined as a SETA symbol in the same definition), the following 
statements could be part of the same macro definition. 


1 | CA 5 

2 | &PSH(&A) (6 LT 2) 

3 | &TSW(9) (SPSM (SA)) 

4 2,-F'&SBOX(45)' 

5 AREA,C"&WBOX( 17) * 


Statement 1 assigns the arithmetic value 5 to the nonsubscripted SETA symbol 
&A. Statements 2 and 3 then assign the binary value 0 to subscripted SETB 
symbol &PSW(5) and £TSW(9), respectively. Statements 4 and 5 generate 


statements that add the value assigned to &SBOX(45) to general register 2, 
© and compare the value assigned to &WBOX(17) to the value stored at AREA, 
respectively. 
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4-18 CONDITIONAL ASSEMBLY INSTRUCTIONS 


The terms and expressions that are valid operands of the SET instructions 
may be used in conjunction with the conditional assembly instructions to 
indicate to the assembler the order in which statements should be 
processed. 


There are 8 conditional assembly instructions which are described in this 
section. 


AIFIB] ANOP NTRAC 
AGOLB1 MEXIT GSEQ 
ACTR MTRAC 


All of the above statements may be used inside and outside macro definitions, 
except as noted in the text. 


The AIF[B1, AGOLB], АМОР and MEXIT instructions may be used to vary the 
sequence in which statements are assembled into a program. The programmer 
uses these statements to test the attributes of macro instruction operands 
and symbols defined in the program, and to test the current values of 
variable symbols, in order to determine which statements should be assembled. 
The ACTR instruction may be used to limit the number of AIF and AGO branches 
that are executed in an assembly. 


MTRAC and NTRAC are used to trace the conditional logic of a macro definition 
or the source program at assembly time. MTRAC causes conditional statements 
to be listed with an indication, where applicable, of whether branching 
occurred. NTRAC negates the MTRAC function. 


The GSEQ instruction is used to define conditional transfer points whose 
names may be generated, at assembly time, by variable symbols in the sequence 
symbol field of AIF[B1 and AGO[B] statements. 


Examples of all conditional assembly features are given throughout this 
section. A chart summarizing the elements which may be used in each 
instruction appears at the end of this section. 


4.18.1 Sequence Symbols 
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Sequence symbols may be used in the name entry of most assembly language 
statements. They allou the programmer to refer to selected statements in the 
operands of the conditional instructions AIF[B] and AGO[B1. 


A sequence symbol may be used in any statement that does not contain a symbol 
or SET symbol except: 


MACRO, LCLA, LCLB, LCLC, GBLA, GBLB, GBLC, GSEQ, ACTR, ICTL, ISEQ and START. 
Sequence symbols may be written in a standard form or may be generated by 
variable symbols. The standard from of a sequence symbol consists of a 
period followed by one through seven letters and/or digits, the first of 


which must be a letter. A sequence symbol used in the name entry of a 
statement must be written in standard form. 
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C Sequence symbols that appear in the operands of the conditional instructions 
may be written in standard or generated form. A generated sequence symbol 
consists of a period followed by 
1. a variable symbol, or 


2. a symbol followed by a variable symbol. 


After all variables have been replaced by their current values, the 
resulting characters must form a standard sequence symbol. 


If a sequence symbol is to be generated at assembly time, it must appear in 
the operand of a GSEQ statement. The GSEQ statement is described below. 


Sequence symbols are local symbols. Thus, if the same symbol is used inside 
and outside a macro definition, or in two or more macro definitions, it is 
considered to be a different symbol in each case. 


The following are valid standard form sequence symbols: 


. READER .A23456 
S . LOOP2 .X4F2 
«N .54 


The following are valid generated sequence symbols: 
.&LOOP . LOOP&AG1 . TAG&BG2 


The following are invalid sequence symbols: 


CARDAREA (first character is not a period) | 

- 246B (first character after period is not a letter) 

. AREA2456 (more than seven characters after period) 

. BCDX84 (contains a special character other than initial period) 
. IN AREA (contains a blank) 


If a sequence symbol appears in the name entry of a macro instruction, and 
the corresponding prototype statement contains a symbolic parameter in the 
name entry, the sequence symbol does not replace the symbolic parameter 
wherever it is used in the macro definition. 


© The following example illustrates this rule. 
1 | NAME &TO,&FROM 
2 | &NAME 2, SAVEAREA 
2 ,&FROM 
2,810 
2,SAVEAREA 


3 MOVE FIELDA,FIELDB 
4 ST 2, SAVEAREA 
L 2,FIELDB 
ST 2,FIELDA 
L 2, SAVEAREA 
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If an AIF instruction appears in a macro definition, then the sequence ә 
symbol that is written or generated in the operand must appear in the 
name entry of a statement in that definition. 


If an AIF instruction is used outside macro definitions, then the sequence 
symbol that is written or generated in the operand must appear in the name 
entry of a statement outside macro definitions. 


Sequence symbols which may be generated by variable symbols must appear in a 
GSEQ statement in the macro definition or source program, depending on the 
placement of the conditional statement which references the symbol. 


The following are valid operands of AIF instructions: 
(&AREA*X'2D' GT 29).READER 

(T'&P EQ -F“). THERE 

(&AG1-3 GE 3*X*"05") .&TAG 

(&BL1).LOOP&AL 1 


The following are invalid operands of AIF instructions: 


Ce 


(T'&ABC NE T*&XYZ) (no sequence symbol) 

.X4F2 (no logical expression) 

(T'&ABC ΝΕ T'&XYZ) .X4F2 blanks between logical expression and sequence 
symbol 


The following macro definition may be used to generate the statements needed 
to move a full-word fixed-point number from one storage area to another. The 
statements will be generated only if the type attribute of both storage areas 
is the letter F. | 


&T,&F 

(T'&T ΝΕ T'&F).END 

(T'&T NE 'F').END 

2, SAVEAREA 

2,&F 

2,8 

2, SAVEAREA 2 


The logical expression in the operand of statement 1 has the value true if 
the type attributes of the two macro instruction operands are not equal. 
If the type attributes are equal, the expression has the logical value false. 


Therefore, if the type attributes are not equal, statement 4 (the statement 
named by the sequence symbol .END) is the next statement processed by the 
assembler. If the type attributes are equal, statement 2 (the next sequential 
statement) is processed. 


The logical expression in the operand of statement 2 has the value true if 

the type attribute of the first macro operand is not the letter F. If the 

type attribute is the letter F, the expression has the logical value false. 
Therefore, if the type attribute is not the letter F, statement 4 (the 
statement named by the sequence symbol .END) is the next statement 

processed by the assembler. If the type attribute is the letter F, statement 3 
(the next sequential statement) is processed. 
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C Generated sequence symbols and AIF instructions used outside macro definitions 
are illustrated in the next example. 


&B 
LOOP1,LOOPO 


(&B EQ 1).LOOP&B 
(&B EQ 0).LOOP&B 


. LOOPO 


S .LOOP1 


Additional illustrations follow the description of the AGO, ANOP and MEXIT 
instructions. 


5C 


10C 


4.18.6 AGO - Unconditional Branch 


The AGO(B) instruction is used to’unconditionally alter the sequence in which 
source program or macro definition statements are processed by the assembler. 


The format of this instruction is: 


© A AGO or AGOB A sequence symbol 
| sequence 

symbol or 

blank 


The AGOB operation code is provided for TOS macro language compatibilitv. 
It may be used interchangeably with the AGO operation code. 


The statement named by the sequence symbol in the operand is the next 
statement processed by the assembler. 

The statement named by the sequence symbol may precede or follow the AGO 
instruction. 

The sequence symbol in the operand entry may be in standard form or it may 
be generated. All rules that apply to sequence symbols in the AIF instruction 
operand are valid for the AGO instruction. 
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The following example illustrates the use of the AGO instructions: 


&T,&F 

(T'&T EQ 'F').FIRST 
. END 

(T'£T NE T'£F).END 
2, SAVEAREA 

2.&F 

2,&T 

2, SAVEAREA 


Statement 1 is used to determine if the type attribute of the first macro 
instruction operand is the letter F. If the type attribute is the letter F, 
statement 3 is the next statement processed by the assembler. If the type 
attribute is not the letter F, statement 2 is the next statement processed 
by the assembler. 


Statement 2 is used to indicate to the assembler that the next statement 
to be processed is statement 4 (the statement named by sequence symbol .END). 


An AGO instruction is used below to branch around the definition of symbol A 
and one definition of symbol B. Not that attribute information for A will 
not be affected by the absence of Α in the assembled program. The attributes 
of B, however, are undefined, although only one definition of B is 
generated. 


.L1 
А F'00' 
„LI (T'A NE F“). END 
B Н" 00” 

‚12 
В R 00' 
12 (T'B ΝΕ 'H*).END 
. END 
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C 4.18.5 ANOP - Assembly No Operation 


The ANOP instruction facilitates conditional and unconditional assembly 
time branching to statements whose name entry must be other than a sequence 
symbol. 


The format of this instruction is? 


A Blank 
sequence 
symbol 


If the programmer wants to use an AIF or AGO instruction to branch to 
another statement, a sequence symbol must be placed in the name entry of the 
statement to which the branch is to take place. However, if the programmer 
has already entered a symbol or variable symbol in the name entry of that 

C statement, a sequence symbol cannot be placed in the name entry. Instead, 
the programmer must place an ANOP instruction before the statement and then 
branch to the ANOP instruction. This has the same effect as branching to the 
statement immediately after the ANOP instruction. 


The following example illustrates the use of the ANOP instruction. 


MACRO 

MOVE &T,&F 

LCLC &TYPE 

AIF ` (T'£T EQ 'F').FTYPE 
SETC Е" | 


ANOP 

ST&TAPE 2, SAVEAREA 
L&TYPE 2,&F 
ST&TYPE 2,&F 
L&TYPE 2,SAVEAREA 


C MEND 


TOC NES 


Statement 1 is used to determine if the type attribute of the first macro 
instruction operand is the letter F. If the type attribute is not the letter F, 
statement 2 is the next statement processed by the assembler. If the type 
attribute is the letter F, statement 4 should be processed next. However, 
since there is a variable symbol (&NAME) in the name field of statement 4, 

the required sequence symbol (.FTYPE) cannot be placed in the name field. 
Therefore, an ANOP instruction (statement 3) must be placed before 

statement 4. Then, if the type attribute of the first operand is the letter F, 
the next statement processed by the assembler is the statement named by 
sequence symbol .FTYPE. The value of &TYPE retains its initial null character 
value because the SETC instruction is not processed. Since .FTYPE names an 
ANOP instruction, the next statement processed by the assembler is 

statement 4, the statement following the ANOP instruction. 
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The example below illustrates the use of the ANOP statement in con junction 
with forward and backward conditional transfers. 


£A,£B 
(*£A'EQ' ').12 


£A. (4) ,£B 
„ЕЗ 


UR WRN = 


"САМЕ" 
A(0) 
. II 


ο 


Statement 1 is used {ο test for the presence of the first operand. If the 
operand is present, its value is used in statement 2, and the macro 
processing is terminated bv statement 3. If the operand is omitted, the SETC 
statement in line 5 is used to create a value for ΣΑ. Because the SETC 
statement requires a variable symbol in the name entry, the ANOP statement in 
line 4 is necessary for branching. Statement 6 results in a transfer back to 
line 7. The instruction in statement 2 is then generated with the new value 
of &A. 


4.18.6 MEXIT - Macro Definition Exit 


4-78 


The MEXIT instruction is used to indicate to the assembler that it should 
terminate processing of the current macro definition. 


The format of the MEXIT instruction is: 


A MEXIT Blank 
sequence 

symbol or 

blank 


The MEXIT instruction may only be used in a macro definition. It should not 
be confused with the MEND statement which must be the last statement of 
every macro definition, including those that contain one or more MEXIT 
instructions. 


When the assembler detects a MEXIT instruction within a macro definition, 
the next statement processed will be the statement that immediately follows 
the corresponding macro instruction. If the macro instruction appeared in 
the source program, the next source program statement will be processed. If 
the macro instruction appeared as a model line in an outer level macro 
definition, the next model statement of that macro definition will be 
processed. | 
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C Conditional instructions, MEXIT and MNOTE statements, and the &SYSLIST feature 
are used in the example below to test the attributes of macro instruction 
operands. 

&A 
&AL1 
&CL1 
. REPEAT ος 
&AL1 SAL1+1 


(*&SYSLIST(&AL1) *EQ**) .OUT 
(T'&SYSLIST(&AL1) EQ N“). LI 

&CL1 T'&SYSLIST(&AL 1) 

1,'PARAM &AL1 IS NOT SELF DEFINING’ 
2,'TYPE IS &CL1*' 

(&AL1 NE 3).REPEAT 


SYM,&SYSLIST(&AL 1) 
(&AL1 NE 3).REPEAT 


Statement 1 increments an arithmetic local variable symbol that is used 

as a parameter counter. In statement 2, a test is made to determine if a 
corresponding operand was supplied. If not, the macro processing is terminated 
by a branch to the MEXIT instruction. Otherwise, a test of the type attribute 
is made in statement 3. If the type attribute is self-defining, line 7 is 
processed and a move of the parameter to SYM is generated. If the expression 
in line 3 is false, the MNOTE statements in statements 4 and 5 are used 

to warn the programmer that the desired conditions are not satisfied. The 
tests are repeated until the arithmetic expression in statement 7 is false; 


i.e., &ALl equals 3; or until an operand is omitted. 
* 


4.18.7 ACTR - Conditional Assembly Loop Counter 
© The ACTR instruction is used to limit the number of AGO and AIF branches 
executed within the source program. 


A separate ACTR statement may be used in each macro definition and in the 
main program. These counters are independent. 


The format of this instruction is? 


Not used ACTR Any valid SETA expression 
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This statement causes a counter to be set to the value in its operand. Each 
time an AGO or AIF branch is executed, the counter is decremented bv one. 
If the count is zero before decrementing, the assembler takes one of two 
actions: 


1. If a macro definition is being processed, the processing of it and any 
macros above it in a nest is terminated, and the next statement in the 
main portion of the program is processed. 


2. If the main portion of the program is being processed, conditional 
assembly is terminated, and the portion of the program generated so 
far is assembled. 


If an ACTR statement is not given, the value of the counter is assumed to 
be 1200. 


4.18.8 MIRAC - Macro Trace 


The MTRAC instruction allows the programmer to determine the effective 
conditional transfers within a macro definition or the source program. If 
MTRAC is specified, each conditional instruction (see section 4.18) is 
printed on the assembly listing and a "Y" or "N" designation in column 80 
indicates whether or not the branch was performed. The definition of the 
local and global SET parameters (see section 4.14.2) is likewise printed 
on the assembly listing if MTRAC is specified. 


Every current value of an executed SET instruction (SETA, SETB, SETC) and 
every ACTR operand is printed in columns 73-80. 


a) SETA parameters and ACTR operands: shown in columns 73-80 as decimal 
numbers with leading zeros; for negative values, rather than indicating 
a sign, the last digit is shown as follows: 


0 is not printed 5 = N 
1 = J 6 = 0 
2 = K 7 =P 
3 = L 8 = Q 
4 = M 9 = R 


For numbers that have more than 8 digits, an asterisk (X) is printed in 
column 73, followed by the 7 least-significant digits. 


b) SETB parameters: shown as a single character in column 80; 'T' - true 
or (1); "F" = false or (0). 


c) SETC parameters or symbolic parameters in SETC statements: shown as a 
sequence of up to eight characters, beginning with column 73, space-filled 
(omitted parameter is printed as ..NULL..). If the sequence has more than 
9 characters, then only the first 7 characters are printed and an asterisk 
(X) is placed in column 80. 


4-80 Assembler V29.1C, U62-J-255-6-7600 


Conditional assembly instructions 


The format of the MTRAC instruction is: 


Sequence | MTRAC Blank 
symbol or 
blank 


The MTRAC instruction may be used inside and outside macro definitions. If 
the NOGEN option is on, MTRAC has no effect. 


Note 


If the MTRAC function is activated in a higher-level library macro, it is 
applicable to lower-level macros even if these were called in the program 
before the MTRAC instruction proper. 


4.18.9 NTRAC - No Trace 


Ihe NTRAC instruction negates the MTRAC function. The format of the NTRAC 
instruction is identical to the format of MTRAC instruction. 
If MTRAC is not specified, any NTRAC processed has no effect. 
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4.18.10 Conditional Assembly Elements 


The following chart summarizes the elements that can be used in each 
conditional assembly instruction. Each row in this chart indicates which 
elements can be used in a single conditional assembly instruction. Each 
column is used to indicate the conditional assembly instructions in which a 
particular element can be used. 


The intersection of a column and a row indicates whether an element can be 
used in an instruction, and if so, in what fields of the instruction the 
element can be used. For example, the intersection of the first row and 

the first column of the chart indicates that symbolic parameters can be used 
in the operand field of SETA instructions. 


Variable symbols 


1) Only in character relations 

2) Only in arithmetic relations 

3) Only if value is a self-defining term 

4) Only in character or arithmetic relations 

5) Only if value is a decimal self-defining term 


Abbreviations 

N - is Name 1; = is Integer Attribute 
D = is Operand K* = is Count Attribute 
S.P. = is Symbolic Parameter N' - is Number Attribute 
L" = is Length Attribute S.S. = is Sequence Symbol 
Ss’ = is Scaling Attribute 
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ç 5 POST-ASSEMBLY DIAGNOSTIC ROUTINE CADIAG) 


5.1 USAGE 


The Post-Assembly Diagnostic Routine (ADIAG) is a conversational routine 
which has been specially generated for version 29.1 of the assembler, and 
which performs the following basic functions: 


€ output of diagnostic information about a preceding assembly 5 


e input/output mapping in conversational mode 


e COMOPT-controlled, implicit start via the assembler when a particular 
C error severity is reached 


è explicit start via a /EXEC command 


ϱ correction of the source program in conversational mode with the aid of 
the file editor EDT 


e restart of the assembler 


€ matching of the diagnostic program to the reorganization of the assembler 
flags 


It is a prerequisite of using the ADIAG 2 V29.1 that the diagnostic file 
has been generated by the assembler 2 V29.1, i.e. diagnostic files generated 
using previous assembler versions cannot be evaluated using ADIAG V29.1; 
similarly previous ADIAG versions cannot evaluate the diagnostic files of 
the assembler V29.1. 


The diagnostic file is generated using one of the following entries: 


SAVLST 
є —  xCOMOPT during assembly 
ADIAG- 


— PARAM SAVLST=ALL prior to calling the assembler 


The diagnostic program may be initiated either explicitly by means of an 
ZEXEC command or implicitly by means of the assembler. 

When an implicit start is selected the $ADIAG maintained in the system 
catalog is always initiated. This start is initialized by entering xCOMOPT 
ADIAG-n, and takes effect if a particular error severity is determined during 
the assembly. 

When *COMOPT ADIAG=O is entered, the $ADIAG is initiated irrespective of 

any errors which might arise. 


The diagnostic program can be initiated either in conversational mode or in 
batch modes; however, not all ADIAG commands can be processed in batch mode. 
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5-2 DEFINITIONS 


Diagnostic file 


An ISAM file generated by the assembler and containing the diagnostic in- 
formation. 


ADIAG command 
Command to the diagnostic program to perform certain services. 
Severity code 


All errors determined by the assembler during assembly of a program are 
assigned one of the severity codes described below: 


Code Severity code| Description 


WAR WARNING; 
Warning - successful program run possible 
SIG SIGNIFICANT ERROR: 
Error - illegal program run possible 
SER SERIOUS ERROR; 
Serious error - program run not possible 
FAT FATAL ERROR; 
Fatal error - assembly terminated; diagnostic 
file incomplete 
Error type 


One of the letters A-Z with which each error code begins. 


Error code 


Error type followed by one or two digits used to identify an error. 


Error text 


Verbal description of an error code. 
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© 5-3 STRUCTURE AND USE OF THE DIAGNOSTIC FILE 


5.3.1 Structure 


The Diagnostic File is created (optionallv) at assemblv time. The file will 
contain all data that appears in an assembly listing, plus some additional 
information for the diagnostic program. 

The Diagnostic File is an ISAM file. It is generated optionally using the 
corresponding COMOPTs SAVLST or ADIAG-n. If the COMOPT ADIAG-n is entered, 
this implies a SAVLST entry. If the PARAM command /PARAM SAVLST-ALL is 
specified prior to calling the assembler, a diagnostic file containing the 
entire assembly listing will likewise be generated. 


Ç 5.3.2 Naming the Diagnostic File 


The assembler generates diagnostic files with the following names: 


SAVLST 
Entry: %COMOPT or /PARAM SAVLST=ALL 
ADIAG- 
Filename: SAVLST.ASSEMB.<name of lst CSECT> with file link name 
SAVLINK 
SAVLST.ASSEMB. <tsn> 


if the lst CSECT is unnamed 


If the diagnostic file is to be given a different name, a FILE command with 
the file link name SAVLINK must be entered before calling the assembler. 


Note 
C If, in a job, the assembler is started more than once by means of the 
SAVLST option, a /RELEASE SAVLINK must be issued before every restart of 


the assembler to avoid overwriting. 
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5.4 


5.4.1 


5.4.2 


5-4 


START OF THE DIAGNOSTIC ROUTINE 


The ADIAG can be initiated either explicitly by means of an /EXEC command or 
implicitly by means of the assembler. 


Explicit Start 


The ADIAG is started by means of an /EXEC command. The mechanisms triggered 
by this start correspond to those for an implicit start. 


Implicit Start 


The COMOPT ADIAG=n permits the user to initiate the diagnostic routine by 
means of the assembler in accordance with the highest severity code 
encountered during the assembly. The start is performed only after xEND 
HALT or xHALT is entered. 

The meaning of the value n is as follows: 


n ADIAG start 
0 Following the assembly, irrespective of the assembly result 


1 On encountering the WAR severity code (warning) ог a higher severity code 


2 On encountering the SIG severity code (significant error) or a higher 
severity code 


3 On encountering the SER severitv code (serious error) or a higher 
severitv code 


If a fatal error is encountered the ADIAG is not initiated implicitlv bv 
the assembler. 


Following initiation the diagnostic program attempts to open a diagnostic 
file using the file link name SAVLINK. If this is not possible, it is up to 
the user to specify a diagnostic file by means of the ADIAG command OPEN. 
When the file has been opened, the ADIAG evaluates in the diagnostic file the 
information that is beyond the scope of the assembly listing, outputs 

this information and waits for further ADIAG commands to be entered. 
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COMMAND INTERRUPTION 


If the user is requested to enter an ADIAG command, he can branch to 
system mode and enter BS2000 commands by pressing the BREAK key. 
The interrupted ADIAG run can be continued by entering the RESUME command. 


ADIAG COMMANDS 


IADAG is controlled by means of commands. These are read in interactive 
mode with the aid of the NRTRD macro. In batch mode and by setting program 
switch 1, the commands are read from SYSDTA. In interactive mode, the 
commands must always be entered on the first line (command line) of the 
screen. 


General format: 


<commandname> [<operand>[ ,<operand>...1] 


Overview of ADIAG Commands 


Command Function 

CDT Calls the file editor EDT for correcting source lines 

COMOPT Lists the COMOPTs entered during the assembly (with modification 
option) 

DISPLAY Outputs error causes and numbers of affected statements on the 


data display terminal 


END Terminates execution of the Diagnostic Program 

HELP Lists and explains ADIAG Commands 

LIST As DISPLAY, but outputs on the basis of SYSLST 

OPEN Opens a diagnostic files; assembly result in abbreviated form 

PRINT Lists statements 

RERUN Starts the assembler using the valid COMOPTs 

SYSTEM  Executes a system command 

TAGS Produces a list of all symbols that are multiply defined and/or 
unde f ined 

XREF Lists cross-reference data 
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5.6.2 Command Definitions 


5.6.2.1 CDT Command 


5-6 


Format: CIDT] [<parameter>[ ‚<parameter>[ ‚<parameter>]11] 
Parameter: 


<errortype> 
<parameter>s: 3 =] <errorcode> 
<statementno.> 


Function: 


The file editor EDT is initiated as a subroutine, and the corresponding 
source program file (or corrections file) is opened. The statement with the 
specified number or all statements with the identified error must be 
corrected. 


CDT Command without parameter 


If the command is entered without a parameter, it is up to the user to 
search for invalid source lines and to correct these. The EDT is started 
and the source file opened in full screen mode. It can then be processed 
using the EDT options. After you have saved the file, the EDT command 
HLALT] is used to return to the ADIAG. Further parameter-controlled 
processing of the source using the CDT command is then generally no longer 
possible (see Notes). 


CDT command with parameter 


The program environment (the next 4 source lines) is output additionally 

to each invalid source line. The invalid line can then be corrected using 
the standard EDT procedure. 

The next invalid source line is then displayed together with its program 
environment. 

This procedure is repeated until all desired corrections have been processed. 
If no corrections are made, @RETURN is used to scroll to the next line to be 
corrected. | 

When the EDT commands aPRINT or @LIST have been executed there is no scrol- 
ling, but rather the source lines previously output is output again. 


Restriction: 


When this procedure is used only the following EDT commands are permitted: 
@RETURN, aPRINT, @LIST, aSAVE and ΘΜΕΙΤΕ. 
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© Notes: 


— Source statements which originate a 'MULTIPLY DEFINED SYMBOL' flag are 
processed at the end of automatic scrolling. 


— It is up to the user to eliminate 'UNDEFINED SYMBOL' flags following 
automatic scrolling. 


— If a corrections file was involved in the preceding assembly, then first 
the source file and then the corrections file (if affected) are processed 
by means of the above procedure. 


— The assembler determines the assignment between the statement number and 
the source line number during the assembly. This assignment may not be 
destroyed during automatic scrolling, e.g. source lines may only be 
deleted following termination of scrolling by the user. 


Attention 
C The CDT command is not possible in batch mode. 


The processing of library members with the CDT command is not possible. 


5.6.2.2 COMOPT Command 
Format: СОГМОРТЈ 


Function: 

The COMOPTs set when the diagnostic file is created are displayed on the 
data display terminal; they can be redefined for a new assembly initiated 
by means of the RERUN command. This is achieved by modifying the screen 
display directly, then entering the next ADIAG command in the command line. 


Note: 


6 This function is not possible in batch mode. 
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5.6.2.3 DISPLAY Command 


Format: DLISPLAY] [<parameter>] 


Parameter: 


NAR 
SIG 
SER 


<parameter>: -iMNOTES 


<statementno.> [-<statementno.>] 
<errortype> 
<errorcode> 


Function: 


The error causes with reference to statement numbers are output on the data 
display terminal on condition that the assembly is not aborted (see 
"Special case"). 


Non-parametrized statement: 

Listing of all flags and MNOTES identified, classified according to 
severity code, error code with error text and references to the affected 
statement numbers. 

WAR: 

As above, but only the "Warning" severitv code. 

SIG: 

As above, but onlv the "Error" severitv code. 

SER: 

As above, but only the "Serious error" severity code. 


MNOTES: 


Listing of all MNOTES with assigned severity code and text, followed by 
the statement number. 


<statementno.> [-<statementno.>] 
The invalid statement or statements (no MNOTES) encountered in the 


specified number range are each output on the data display terminal 
with a succeeding error code and error text. 
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= <errortype> 


Listing of the errors of an error type, followed by a precise error code 
and error text and the affected statement numbers. 


~ <errorcode> 
As above, but only the specified error code. 
— Scroll function 


If the output is spread over several screens, it is possible to scroll 
to the next screen bv means of a null input. 


Special case: Assemblv aborted 


If the assembly is aborted, it is not possible to generate a complete 
SAVLST. Two different outputs are then possible depending on the cause 
of the abortion: 


1. Abortion with error severity 3 (i.e. continuation of assembler run 
not possible): 


The error text is output with notes referring to the possible causes. 
In such cases all parameters in the DISPLAY statement are ignored. 


2. Controlled abortion by entering the highest error severity: 


All statements so far flagged are output similarly to an ERRFIL. These 
must however include at least the statement triggering the abortion 
(e.g. MNOTE with SEV-CODE=255). ! 

In such cases DISPLAY parameters are accepted with restrictions (state- 
ment references are always excluded). 
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5.6.2.% END Command 
Format: ECND] [L] 
Function: 
The diagnostic program is terminated. If the supplement 'L' is added, the 
assembly listing is output via SYSLST. Files that are open are closed. 
5.6.2.5 HELP Command 
Format: HLELP] [<command>] 
Function: 


Listing of all ADIAG commands or description of selected ADIAG commands on 
the data display terminal. 


Note: 


This function is not possible in batch mode. 


5.6.2.6 LIST Command 


Format: LIISTI [<parameter>] 


Parameter: 
See 5.6.2.3, DISPLAY Command 
Function: 


Similar to DISPLAY command, but output to SYSLST. 
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5.6.2.7 OPEN Command 


Format: OLPEN] «filename» 


Parameter: 

SAVLST. ASSEMB. <CSECT-name> 

<filename>:: = +SAVLST.ASSEMB.<tsn> with file link name SAVLNK 
file name 


Function: 


The diagnostic file specified is opened, and any previously opened diagnostic 
file with a different name is closed beforehand. The assembly listing is 
output to the appropriate output medium in abbreviated form. 


5.6.2.8 PRINT Command 


Format: 


<statementno. >L-<statementno. >] 


PLRINT] d ΠΠ 


«symbol.»[-«symbol»1 
Function: 

Lists a specified statement or a specified range of statements as they 
would appear on the assembly listing. If no range is specified, all state- 
ments are listed. However the rightmost characters of any line extending 
beyond 80 columns are truncated on the data display terminal. 

Specifying 'S' causes only the following information of a line to be 
output: 

— location counter 

— statement number 

— source statement. 

Specifying 'L' triggers an additional, complete output of the printed lines 
as per SYSLST. The error codes and error texts are inserted after the 


affected statements. 


If the output is spread over several screens, it is possible to scroll to 
the next screen by means of a null input. 


Note: 


Not possible if the assembly is aborted. 
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5.6.2.? RERUN Command 


Format: RLERUN] 
Function: 


The assembler is restarted bv means of the COMOPTs as set on creation of the 
diagnostic file, or as reset by means of a preceding COMOPT command. 


Note: 


This function is not possible in batch mode. 


5.6.2.10 SYSTEM Command 


Format: SLYSTEMI<parameter> 

Parameter: 

<parameter>s t="system-command' 

Function: 

The system command, enclosed in apostrophes, can be specified with or 
without slash. It is executed right away and, subsequently, the ADIAG run is 


continued, as far as the preceding system command allows. 


All commands are allowed if they are called by means of the CMD macro (see 
"Executive Macros" reference manual). 


Note: 


ADIAG remains loaded and open files are not closed throughout command 
execut ion. 


5.6.2.11 TAGS Command 


Format: TLAGS] [«type»[,«type»11L, XE REF! 


Parameter: 


; M 
«type»::- 
U 


Default value: M,U 
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Function: 


Lists all symbols that are undefined (U) and/or multiplv defined (M). Cross- 
reference data is also listed if XREF specified. 

If the output is spread over several screens, it is possible to scroll to the 
next screen bv means of a null input. 


Note: 


This function is not possible in batch mode or if the assembly is 
aborted. 


5.6.2.12 XREF Command 5 


Format: XCREF] <parameter>[ ‚<parameter>[ ‚<parameter>]] 
Parameter: 


| <symbol >[ -<speci fication>] 
<parameter>s š =) *<macroname> 


<literal> 

x 

A 
κ 
<speci fication>3:= 

W 

E 

0 


Function: 


The cross-reference data for the symbols, macro names or literals specified 
is displayed on the data display terminal. 

If xCOMOPT ATXREF was specified during the assembly, it is possible to 
request certain cross-references for symbols: 


: Definition line 

: Address accesses 

: Non-write accesses via commands 

: Write accesses 

š Symbol for EQU-/ORG statement 

: Other accesses via assembly statements. 


If the output is spread over several screens, it is possible to scroll to 
the next screen by means of a null input. 


Note: 


Not possible if the assembly is aborted. 
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5.6.3 Formatted Screen L/O 


Example: Basic structure of ADIAG formats 


CMD: аааааааа VERSION: V29.1C 


BASIC STRUCTURE OF ADIAG FORMATS 


GIVE ADIAG CMD: | 
ааааааааааааааааааааааааааааааааааааааааааааааааааааааааааааааааааа РАСЕ: аа 
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@ Example: DISPLAY Command 


CMD: DISPLAY VERSION: 29.1C 


CLASS FLAG MESSAGE AND STATEMENT NUMBERS 
NONE 
INVALID CONSTANT TYPE 
00006 
QUOTES NOT PAIRED OR ILLEGAL TERMINATION OF QUOTE STRING 
00002 00003 00004 
NONE 


GIVE ADIAG CMD : 
END OF OUTPUT 


PAGE: 1 
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CMDs 


SYMBOL 
ERCSW 


XREF 


Example: XREF Command 


LEN VALUE DEFN 
00001 001ВЕ5 02791 


FLAGTYP 00004 0008F0 
00001 000001 00605 


ON 


GIVE ADIAG CMD : 
END OF OUTPUT 


REFERENCES 


03203W 
05397R 
05535W 
00807R 
03218R 
03681R 
05324R 
05569R 
06804R 


03218R 
0684 1. 
055654 
00896R 
03397R 
04278R 
05397R 
05608R 
06886R 


03415 
06886R 
056554 
01334R 
03443R 
04712R 
05399R 
05609R 
06888R 


0348 1W 
06983R 
07053W 
01675R 
03481R 
05008R 
05408R 
05774R 
06895R 


03580R 
06990R 
0708 1H 
02326R 
03558R 
05248R 
05450R 
05880R 
07330R 


VERSION: 29. 1С 


035818 05288 
069976 

07 138W 

03115R 03203R 
03580R 03592R 
05251R 05318R 
05528R 05568R 
06210R 06597R 
07746R 07773R 
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Assembly 


ASSEMBLING À PROGRAM 


The input of source programs, the output of listings and the internal 
assembly process can be controlled by options. The following possibili- 
ties are provided for entering these options: 


e xCOMOPT statements 
€ PARAMETER command 


e Explicit input. 


*COMOPT STATEMENTS 


xCOMOPT statements are read from SYSDTA 
= as soon as the assembler has been loaded 
— during assembly from SYSDTA after termination of the source program 


— during assembly from file or library after the EOF condition has 
been reached. 


A *COMOPT statement has a maximum length of 80 characters. It begins with 
COMOPT followed by one or more options separated by commas. 

Continuation lines are not possible. The input of xCOMOPT statements 

is terminated by END. 


Any redefinitions of the logical system file SYSDTA are made immediately 
after the *END statement. Subsequently, xSTARTC cards may be read from 
SYSDTA as before if the assignment expects any source program lines from 
SYSDTA. 


The *COMOPT statements are listed completely as soon as at least one 
xCOMOPT statement is used. Errors are output to SYSLST and SYSQUT and can 
be corrected with the aid of another xCOMOPT statement. 


As the assembler, during the input of xCOMOPTs via SYSCMD, and the input of 
the source program, from file or library after termination of the assembly, 
will again call xCOMOPTs for the next assembly, two further control state- 
ments are available in addition to the EOF condition in order to terminate 
the assembler: 


- The HALT operand in the END statement permits the assembler to be 
terminated after the next assembly. 


- The HAL statement instead of an xCOMOPT or END statement causes the 
assembler to be terminated right away. 


— If, inadvertently, invalid information was entered instead of the first 
xCOMOPT command, the assembler will interpret it as the first source 
line. By entering „END you can start the assembly of this invalid 
input, and then enter the correct options for the next assembly. 
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6.1.1 Summary of all Options 


xCOMOPT 


ADIAG-n 


ALTLIBIn1 


NOALTLIBEn] 


ATXREF 


NOATXREE 
COPYMAC 


NOCOPYMAC 
DUET 


ERR=Sm 


Meaning 


A diagnostic file is generated (see COMOPT SAVLST). 
Following the assembly the $ADIAG routine is started 
implicitly when errors with the value n (see section 
5.4.2) or MNOTES with a corresponding severity code 
are encountered. 

0 Sn S 3 


Assigns a macro library or the n-th macro library 
( 2¢n¢€ 5) 


Default assignment 
The references in the cross reference listing are dis- 


played together with an attribute that refers to the 
mode of access. 


h Write access 

k Non-write access bv instructions 
A Address access 

E EQU/ORG statements 

Blank Other assembly statements 


ATXREF is only effective in conjunction with the 
INSTR=SET1 option. 


Default assignment. Not attribute XREF. 

Deactivates the COPY statement as a mnemonic assembly 
code. Any present mnemonic COPY Opcode will be inter- 
preted as a macro instruction. Corresponds to the 
COPY OPSYN statement at the beginning of the program. 
Default assignment 

Allows TRANSDATA 960 instructions 

Default assignment 

The assembly is terminated with TERMJ if more than 

n errors. 

0 < n < 255 

The assembly is terminated with TERMJ if errors with 
the severity m or MNOTES with a class m severity code 


are encountered. 
0 < m S 3 
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xCOMOPT 


ERRFIL 


NOERRFIL 


ERRPR=n 


FLGLST 

NOFLGLST 

HWTST 
OHW 


SETI 
INSTR= 
SET 


ISD 


OIS 


Assembly 


Meaning 


Outputs error listing to an error file having the link 
name ERRLINK. If the file is not known at assembly time, 
it is created with the name 


<TSN> | 
<CSECT пате> 


ERRFTL. assem. 


Note:: 
If ERRFIL and SAVLST are specified simultaneously, 
ERRFIL is ignored. 


Default assignment 


Only those error flags with a severity lower than n 
are evaluated for the end message of the assembler 
and for the COMOPT ERR. 

0 <n < 3 Default value: п=1 


Where statements contain error flags the error code 
and the corresponding description are printed after 
the line. 


Where statements contain error flags the error types 

(max. 3) are printed in the left-hand margin of the 

line. | 

For special tests the CCW flag may be transferred 

unmodi fied (unabbreviated). However, this occurence 

itself will be flagged. 

No unmodified transfer of the CCW flag byte. 

Specifies the instruction set to be generated. 

SET1 Instruction set of systems 7.500 or 7.700 
(see Appendix A. 6) 


SET2 Instruction set of system 7800 
(see Appendix A.7) 


The assembler outputs ISD cards to the object module. 


Default assignment 
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*COMOPT 


LINECNT=n 


LIST 


NOLIST 


MCALL 


NOMCALL 
MDIAG 


NOMDIAG 
MLPRNT 


NOMLPRNT 


MODULE= 
speci fication 


NDLIST 
NONDLIST 


QUTPUT-filename 


PROCOM 


NOPROCOM 


PRTALL 


NOPRTALL 


Meaning 


Line/print page control, including header line 
(15 < n S 255). 
Default assignment: n - 60 


Default assignment. The assembly listing is output to 
SYSLIST. 


Only the invalid statements are displayed. 


Causes inner macros of library macros to be read only 
if they are defined in a MCALL statement. 
Only these macros can be expanded. 


Default assignment 


Macro definitions of library macros are to be printed; 
generation is inhibited. 


Default assignment 


The macro identification line consisting of version 
number, creation date and link name of the macro 
library is output to the assembly listing. The version 
number consists of blanks if the macro was entered in 
the macro library by the MLU utility routine. 


Default assignment 
Specifies where the object module is to be output to. 


If this option is not used, the object module is output 
to the EAM fíle. 


For a full description of this option see section 6.1.3. 


Generates laser printer oriented assembly listing. 
Default assignment 


Only in combination with xCOMOPT UPD. The corrected 
source program is output to the specified file. 


Qutput of program complexity metrics of the source 
program (see Appendix A.10). 


Default assignment. No output of program complexity 
metrics. 


Generates a complete assembly listing. The options of 
the PRINT statement, NOGEN, OFF, NOCOPY, NOREF and xOFF, 
are suppressed. 


Default assignment 
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LI 


xCOMOPT 


PRIIT 


NOPRTIT 
PRTOFF= 


[ 
ΧΙΓΙΧ21...[1Χ5} 


SAVLST 


NOSAVLST 


SEQ- (number 
[,lengthL[,id11) 


| 


Assembly 


Meaning 


The effect of the TITLE statements generated by means 
of macros is maintained, even if printing of the TITLE 
the TITLE statements is suppressed by means of PRINT 
NOGEN. 


The effect of the TITLE statements generated by means 
of macros is suppressed by means of PRINT NOGEN. 


The statements generated by means of macros are either 
printed or not printed, depending on the macro stage 
and the first character of the macro name. 


n Statements generated by means of macros are not 
printed as of the n-th macro stage. 
1 < n < 250 
X1L5X21. . [5X5] 6 


Statements generated bv means of macros are never 
printed if the first character of the macro name 
is specified in the list X1 to X5 (irrespective 
of any macro stage set by means of PRTOFF=n). 
This list may contain up to five first characters 
of macro names; all macros whose name begins with 
one of these characters are affected. 


The assembly listing is output to a diagnostic file 
having the link name SAVLINK. If the file is unknoun 
at assembly time, it is created with the name 


«TSN» 
sans assene. | | 
<CSECT name> 
Note: 
If SAVLST and ERRFIL are specified simultaneously, 
ERRFIL is ignored. 


If, in a job, the assembler is started more than once 
by means of the SAVLST option, a /RELEASE SAVLINK must 
be issued before every restart of the assembler so as 
to avoid overwriting. 


Default assignment 


Specifications for the identification field in the 
assembly listing or in the corrected source program 
(see option OUTPUT= ). 
number - Initial numbering with an increment of 100 
for the identification field. 
Leading zeros may be omitted. 
length = Length of numbering, starting from the right 
in the identification field (4 <S length S8). 
Identifier to be copied into the identifica- 
tion field starting with column 73 (up to 4 
characters). 
These entries are interpreted only if option SOURCE 
or SOURCE and UPD are specified. 
If input is from SYSDTA, the entries are ignored. 


id 
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*COMOPT 


SOURCE- 
specification 


SYSPARM- 
'max. of 8 
characters" 


UPD= 
specification 


End of Option Input 


xEND 


XEND HALT 


XHALT 


Meaning 


Specifies the source from which the program is to be 
read. 

If this option is omitted, the program is read from 
SYSDTA. For a full description of this option see 
Section 6.1.2. 


The system parameter &SYSPARM (an eight byte long 
character variable, see section 4.14.1.8) is assigned 
the specified entry and may be interpreted during macro 
processing. 


Specifies the update file from which corrections are 

to be read. 

If this option is omitted, no corrections are expected 
or the corrections are initiated via SYSDTA by means 

of an XSTARTC card (see Appendix A.8 and Section 6.1.2). 
The cross reference listing is output. 


Default assignment. No cross reference listing output. 


Meaning 


End of xCOMOPT statement input and start of assembly. 
Request for new options after assembly. 


‘Same as XEND, but termination of assembler after 


assembly. 


Immediate termination of assembler 
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C 6.1.2 SOURCE Option and UPD Option 


The SOURCE option may be used to specify the location of the source program, 
and the UPD option may be used to specify the location of the update file. 
If the SOURCE option is omitted, the source program will be read from 
SYSDTA. If the UPD option is omitted, the assumption is that there are 

no change lines. 


/ 
+ 
speci fication: x 
file-name 
lib(name) 
plaml ib(member[ (version) 1) 


If no entry is given for "specification", the source pro- 
gram will be read from SYSDTA. 


Z, + and * allowed for UPD. 


© / Ап interrupt will occur. SYSDTA can be assigned bv the 
ZSYSFILE command via SYSCMD. The source program or the 
change lines are then read in via SYSDTA. However, this 
reassignment of SYSDTA does not take effect until the 
options have been processed. 


+ The file specification of the source program or update 
file may be entered via the primary assignment of SYSDTA 
for this task (file from which the LOGON command was 
issued). The file specification may look as follous: 


x 
file-name 
( SYSCMD) 

( PRIMARY) 


If x, (SYSCMD) or (PRIMARY) is specified, the source 
program or the change lines will be read from SYSDTA, in 
the latter case with reassignment of SYSDTA. Otherwise, 
reading in is effected via a file control block. 


ç For UPD, only *, (SYSCMD) and (PRIMARY) are allowed. 


x The source program or the change lines are read from 
SYSDTA. The program text proper is preceded by options. The 
assembler does not, however, need the asterisk to recognize 
and process options preceding the actual text. Therefore, 
the asterisk entry in the source program input is equivalent 
to the missing entry of "specification". 


file-name Name of a cataloged file containing the source program or 
the change lines. 
In this case, reading in is effected via a file control block. 
The name may be up to 54 characters in length, alphanumeric 
with period and hyphen. 


Assembler V29.1C, U62-J-255-6-7600 6-7 


Assembly 


lib(name) 


plamlib 


member 


version 


Remarks 


The source program is read from an LMS library. 


lib is the file name of the library. 
name is the name of the library member. 


File name of the program library created in accordance with 
LMS conventions, and from which the source program is to be 
read (member type = S). 

In accordance with BS2000 conventions, the name may be 

up to 54 characters in length. 


Name of the member of type - S, representing the source 
program. 
The member name may be up to 62 characters in length. 


Version number of the member. 

version may be up to 3 characters in length. 

If version is not specified, the member (type = S) with 
the highest available version number is used. 


— The SOURCE option, in its entirety, must not exceed 80 characters, which 
implies that the assembler does not read any successor lines during 


option input. 


Hence, the maximum length of the expression in the SOURCE option to the 
right of the equal sign is 65 characters. 


— Entries in the SOURCE option (library name, member name and version) 
are checked only for admissible length but not for correct syntax 
(similar to LMS conventions). 


— If after *END any source program lines are expected from SYSDTA, 
a XSTARTC card may follow first. The entries on the xSTARTC card take 
priority. Thus a collision between 
xCOMOPT UPD/SQURCE and the xSTARTC card is avoided. 


Attention 


— The maximum length of the name of a called COPY member in the SOURCE 
section of a program library remains 8 characters. 


— Tape processing is only supported via the xSTARTC card. 
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© 6.1.3 MODULE Option 


This option can be used to control output of the object module. If the option 
is omitted, the object module is output to the EAM file. 


x 
specification | ! 


* 
TEMPUS SA κ, [Cversion) 1) 1 
* The object module is output to the EAM file. 


plamlib File name of the program library created in accordance with 
LMS conventions. The object module is stored as a member 
with type = R (module). 
If no program library exists under the specified file name, 
one is created by the assembler. 


member Member name of the object module. 
The member name should be in accordance with the "Rules 6 
for member designations in program libraries", cf 

C LMS manual. 

The member (type = R = module) is kept in the program 

x library under this name (max. 8 characters). If Χ 
(asterisk) is specified, the member is given the name of 
the first program segment (CSECT name) of the object 
module. If the first program segment is unnamed, the 
member is stored not in the program library, but rather 
in the EAM file. 
If the program does not contain a CSECT statement (or 
START statement), then the first DSECT or COM name is 
taken as the name of the object member. The same applies 
if only the library name is specified. 


version Version number of the member. 
version may be up to 3 numerical characters in length. 


Character set supported by LMS 


Letters: A through Z 
Digits: 0 through 9 
Ç Special characters? *.*, '-", "ад" 


If version is not specified, the member is given the 
highest version number (represented in the program librarv 
by means of а а" character, and in the terminal message 
by means of a '-' character). 

If a member with the same version number already exists, 
this member is overwritten. 


Note 


The entries in the MODULE option are not syntax checked (see also the 
notes on the SOURCE option). 
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6.2 /PARAM COMMAND PARAMETERS 


The PARAM command of the BS2000 command language is still evaluated, but 
xCOMOPT statements take priority over identical operands in the /PARAM 


command. 


The PARAM operands relevant to the assembler and the equivalent COMOPT 
options are shown in the following table. 


PARAM operand 


ASMLST=YES 
ASMLST=NO 
SAVLST-ALL 
SAVLST-NO 
SYMDIC-YES 
SYMDIC-NO 
ERRFIL-YES 
ERRFIL=NO 
XREF=YES 

XREF=NO 

ALTLIB=YES 
ΑΙ ΤΙ 1ΒΞΝΟ 


Process switch 


/SETSW ON=(0) 

/SETSW OFF=(0) 
/SETSW ON=(31) 
/SETSW OFF=(31) 


Note 


COMOPT option 


LIST 
NOLIST 
SAVLST 
NOSAVLST 
ISD 
NOISD 
ERRFIL 
NOERRFIL 
XREF 
NOXREF 
ALTLIB 
NOALTLIB 


COMOPT option 


DUET 
NODUET 
MCALL 
NOMCALL 


As of Assembler Version 29.0, task switches should no longer be used 
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C 6.2.1 Description of PARAM operands 
The following operands for the system /PARAM command may be used. 


Al A or B must be entered. If the operand is omitted, the underlined 
default value A is assumed. 
1. Cross-Reference Listing Option 


The following command indicates that a cross-reference listing is (or is not 
to be generated. 


YES 
/PARAM XREF= 


NO 
NO is the normal condition. If XREF = YES, the assembler places a combined 6 
© symbol table map and cross-reference listing in the output file. 


2. Diagnostic File Option 
The following command indicates that a diagnostic file is (or is not) to be 


produced? 


ALL 
/PARAM SAVLST= 
NO 


If SAVLST-ALL, the assembler creates a file to be analyzed later by the 
Post-Assembly Diagnostic Routine (see section 2.7.6). 
3. Error File Option 


The following command indicates that an error file is (or is not) to be 
produced: 


YES 
/PARAM ERRFIL- 


NO 


If ERRFIL-YES, the assembler creates a reduced diagnostic file which lists 
invalid statements only (see section 2.7.6). 


4. Listing Option 
The following command indicates that an assembly listing is (or is not) 
to be created: 


YES 
/PARAM ASMLST= 
NO 


YES is the normal condition. 
The assembler creates an assembly listing, if ASMLST=YES. 
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5. Internal Symbol Dictionary Option * 
The following command indicates that an Internal Symbol Dictionary is (or is 


not) to be produced: 


YES 
ZPARAM SYMDIC- 
NO 


If SYMDIC-YES, the assembler produces ISD records which allow an error 
recovery within the symbols with the use of IDA. 

6. TRANSDATA 960 (DUET) Statement Option 

/SETSW ON=(0) 

This command causes the assembler to recognize and assemble TRANSDATA 960 
statements. It must be used when the assembler is to generate a DNSP 
(communication and network control program for TRANSDATA 960). 


Note: 


TASKSWITCH 0 may not be used by other programs. 


7. Output of Object Modules to the EAM Object Module File 


YES 
/PARAM CARD- 


NO 


YES The object modules generated by the assembler are written to the EAM 
object module file of the task as well as to system file SYSOPT. 


NO Object module output is suppressed unless DISC-YES is specified 
concurrently. 


YES 
/PARAM DISC= 
NO 


YES The object modules generated by the assembler are written to the EAM 
object module file of the task for further processing. The file name 
1 s "nx d 


NO Object module output is suppressed unless CARD-YES is specified. 
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Example 1 (dialog) 


This 


source program file on disc, to check the assembly with the aid of the 
Assembly Diagnostic Program and to do the linkage editing to the program. 


/ERASE x 
/EXEC $ASSEMB 
ΧΧΟΟΜΟΡΤ SOURCEZTEST ————————————————————————————————————— (1) 
ΧΧΟΟΜΟΡΤ XREF,ISD,SAVLST ———————————————————————————————————- (2) 


XXEND HALT 


ZEXE 


OPEN SAVLST.ASSEMB. ICYL 


DIS 
END 


© /ЕХЕ 


xPRO 
INC 
END 
/ EXE 
(1) 
(2) 


(3) 


(4) 


(5) 


(6) 


Assembly 


sample job stream lists the commands to execute an assembly of a 


C SADIAG 
(3) 


(6) 6 
C $TSOSLNK 


ИО II. 5) 


LUDE x 


PLAY 


C TESTA ( 6) 
Name of the source file. 


Further assembly options. 


Open diagnostic file SAVLST.ASSEMB.ICYL (ICYL is the name of the first 
program section) and output assembly result in abbreviated form. 


Display causes of errors and numbers of the associated statements. 


Name of the program and name of the file to contain the linked 
program. 


Start program. 


Example 2 (procedure) 


Read 


ZSYSF 
ZEXEC 
xCOMO 
END 
/ 


source program from file SC.ASSEMB: 


ILE SYSDTA=(SYSCMD) 
SASSEMB 

PT SOURCE=SC.ASSEMB 

HALT 
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Example 3 (procedure) 
Read source program from library PROGLIB, name of member PROG 


/SYSFILE SYSDTA=(SYSCMD) 
/ЕХЕС $ASSEMB 

xCOMOPT SOURCE=PROGLIB( PROG) 
XEND HALT 

/ 


Example 4 


The assembly options are contained in the ASSPAR file. 

The location of the source program should not be specified until the options 
have been processed, and the source program should be on file PROGM in a 
special case. 


Contents of ASSPAR file 


xCOMOPT SOURCE=+ 


r | further options 
END 
Assembly 


ZSYSFILE SYSDTA=ASSPAR 

ZEXEC $ASSEMB 

GIVE INPUT SPECIFICATION FOR SOURCE (assembler request) 
PROGM 

/ 


Alternative: 
Contents of file ASSPAR 


xCOMOPT SOURCE=/ 


° | further options 

END 

Assembly 

/SYSFILE SYSDTA=ASSPAR 

EX EC $ASSEMB 

GIVE SYSFILE CMD TO READ SOURCE (assembler request) 


/SYSFILE SYSDTA-PROGM 
ZR 
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ASSEMBLER TERMINAL AND ERROR MESSAGES 


Normal Terminal Messages 


In interactive mode, the following message appears on the terminal 
immediately after loading: 


VERS.xxxx OF SIEMENS BS2000 ASSEMBLER READY 
(only in interactive mode) 


During the assembly (after the assembly listing has been output and before 
the XREF and/or diagnostic listings have been output) the following 
messages appear? 


FLAGS IN xxxxx STATEMENTS, xxx PRIVILEGED FLAGS, xxx MNOTES 


HIGHEST ERROR HEIGHT: E if no flag has been set. 
according to the highest 
error weight 0<п<2. 

and, if used, the messages: 

USER MACROLIBRARY: filename 

2ND USER MACROLIBRARY: filename 

3RD USER MACROLIBRARY: filename 

4TH USER MACROLIBRARY: filename 


5TH USER MACROLIBRARY: filename 


SYSTEM MACROLIBRARY: filename 


DIAGNOSTIC FILE: filename 
ERRORFILE: filename 


If the source program comes from an LMS library or from a library created in 
accordance with LMS conventions, the name of the library, the name of the 
member, its version number and its creation date are logged in the following 
format: 


SOURCE LIBRARY: library (input library) 
SQURCE PROGRAM: member (input member) 
SOURCE VERS/DATE: ver/yymmdd 


These messages are also output to SYSLST. 
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If the object module generated is output to a program library created in ә 
accordance with LMS conventions, the name of the library, the name of the 
member and the version number are logged in the following format: 


MODULE LIBRARY: library 
LIBRARY ELEMENT: member VERnnn 


Upon assembly, the assembler displays the assembly time used: 
ASSEMBLY TIME x.xxx SEC. 


This message is also output to SYSLST. 
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C 6.4.2 Messages on Reaching Break Condition 


If the assembly is terminated prematurely, either when a fatal error 
(severity code 3) is encountered or when a MNOTE with error code 255 is 
generated, the message below appears on the terminal: 


BREAK CONDITION REACHED ASSEMBLY TERMINATED 
AT LEAST xxxx FLAGS RECOGNIZED - HIGHEST ERROR WEIGHT WAS n 


6.4.5 Error Messages 


If an internal assembler error is detected, a PDUMP and the following 
message is output on SYSLST only: 


ERROR IN ROUTINE WAS CALLED, CHECK THE PDUMP ABOVE T 


C The assembly is continued. 


The following error messages are output to the printer and, in the 
interactive mode, also to the terminal. 


1. Macro Library Errors 


The error message depends on which macro library is currently in use: 


ALTLIBEn] text (user library) (2 < n < 5) 
SYSLIB text (system library) 
texts OPEN ERROR хххх; ELEMENT: macro name 


READ ERROR xxxx; ELEMENT: macro name 
KEY ERROR; ELEMENT: macro name 


XXXX is the error code supplied by the DMS (Data Management System). 


C After the message has been output the assembly is terminated with TERMJ. 


Waiting time when opening a library: 


ALTLIBEn] 
SRCLIB LOCKED, NEXT ATTEMPT AFTER 6 SECONDS 
SYSLIB 


This message is issued if the assembler attempts to open a library that has 
already been opened. 

After 6 seconds another attempt is made to open the library. After 100 
unsuccessful attempts, the following message is output: 


[scu 


SRCLIB | OPEN ERROR 0D99 
SYSLIB 
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2. EAM Errors 


After the following messages have been output, the assembly is terminated 
with TERMD. 


Text: 

EAM ERROR 01 ILLEGAL OPCODE ') 

EAM ERROR 02 ILLEGAL FILENAME 

EAM ERROR 04 ILLEGAL BLOCKNUMBER ') 
EAM ERROR 08 ILLEGAL I/0 ADDRESS ') 
EAM ERROR 10 EAM SPACE EXHAUSTED 
EAM ERROR 20 

EAM ERROR 40 

EAM ERROR 80 

EAM ERROR - KEYS DO NOT MATCH 
Refer to the DMS Manual for a detailed description of the EAM error code. 


1) These error messages refer to assembler errors. 


3. REQM and RELM Errors 


After the error message has been output, the assembler run is terminated with 
TERMD. 


Text: 
REQM FAILED - INSUFFICIENT SPACE AVAILABLE - JOB TERMINATED 
REQM FAILED - INVALID REQUEST - ASSEMB ERROR - JOB TERMINATED 


RELM FAILED - JOB TERMINATED 
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© 4. Error while generating a Diagnostic File 
If an error occurs while opening the file, this message is output: 
OPEN ERROR xxxx(xxxx = DVS error code) 
and a diagnostic file is not then generated. 
If an error occurs while writing to the file, the following message appears: 
ERROR WHILE WRITING TO DIAGNOSTIC FILE. 
(no further action is taken). 


The diagnostic file can accommodate a maximum of 98303 statements. If it is 
attempted to enter more than this number, the error message 


DIAGNOSTIC FILE OVERFLOW - FILE CLOSED. 


is output. 6 


5. Assembler Errors 


When "real" assembler errors occur, the assembly is terminated with ERFLG 
and TERMD, after the message has been output. 


Text: 

BAD CALL TO IOPACKAGE - JOB TERMINATED 

ASSEMBLER ERROR - NO EOF SPECIFIED - JOB TERMINATED 

ASSEMBF ERROR - BLOCKSIZE GREATER THAN 960 FOR OMF - JOB TERMINATED 
INTERNAL ERROR TRYING TO READ BLOCK # GREATER THAN HIGHEST BLOCK NUMBER 
FOR THIS EAM FILE 


6. Errors while writing to SYSLST 


© Text: 


INTERNAL ERROR TRYING TO PRINT A LINE - IF 
ND-LISTING IS REQUESTED, SYSLST MUST BE A 
FILE - PROCESSING CONTINUES 
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7. Errors while processing program libraries 2 
If internal errors are encountered while processing program libraries 

created in accordance with LMS conventions, one of the following messages 

is output and the assembly is terminated with TERMJ (see also next chapter: 

Warnings). 

SOURCE LIBRARY NOT FOUND (OR WRONG LIB-TYPE) 


This message is issued when an existing library cannot be opened. 


SOURCE ELEMENT NOT FOUND 
PLAM RETURNCODE error number 


The meaning of the error numbers is described in the following manual: 

LMS (BS2000) Description (chapter 9). 

8. Miscellaneous Messages 

— When flags B44 or V43 occur in macro calls the following message is issued: 3 
WARNING: MACRO-CALL CAUSED Βάά OR V43 

The flags are output only if *COMOPT ERRPR-0. 


— If a cataloged file with type=PAM is assigned for source input, the 
following message appears: 


ERROR: DISC-INPUT OPEN FAILED (SOURCE-INPUT - PAM-FILE) 


— If after the assembler has been started module ICONTROL cannot be 
loaded, the following message is issued: 


ERROR: MODULE xlICONTROLx CANNOT BE LOADED ASSEMBLY TERMINATED 


6.4.4 Warnings 


1. Warning when incompatible, non-privileged instructions are used. 2 
Whenever the instructions listed below are used, a 021-FLAG will be output. 


In order to avoid compatibilitv problems the following should be borne in 
mind: 


e Starting with BS2000 V8.0 the EXST instruction will no longer be supported 
and should therefore be removed from the program in due time. 


e Тһе LBF, STBF, LWI, STWI, PUSH and POP instructions should not be used 


in neu programs. Their successful execution cannot be guaranteed in the 
long term. 
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© 2. Warning when object module output to program libraries 


If internal errors are encountered when a program library is opened or when 
attaching to a program library, the assembly is not terminated, but rather 
the object module is output to the EAM file. 

The warning below is issued in place of the normal terminal message? 


MODULE LIBRARY: COULD NOT BE ATTACHED OR OPENED, MODULE IS PUT TO EAM 
CAUSED BY PLAM RETURN CODE XXX 


6.4.5 Assembler Error Flags 


The assembler can diagnose up to 5 errors per statement. The errors are 
weighted and assigned one of four severity codes in accordance with their 
effect on execution of the generated object module: 


© Severity| Description 
code 
0 Warning — Successful program run possible 
1 Error — Errored program run possible 
2 Serious error — Successful program run unlikelv 
3 Fatal error — Assembly terminated 


The flag comprises a letter and a number (up to two digits). 

If several errors are encountered “in a single statement, then only a maximum 

of 3 letters for the flags are specified in the first few columns of the 

assembly listing. 

A listing of all flags encountered, sorted according to letters, appears at 

the end of the assembly listing in the diagnostic listing. A brief description 

is appended and cross references are specified for each error. 

If COMOPT FLGLST is used for the assembly, the error flags and descriptions 

are output after the invalid line. In such cases various errors are 

supplemented by additional information designating a symbol or specifying 
© the approximate column of the error in the line. For technical reasons the 

column indicator is generally set to the end of an invalid character string. 


- 


Example: 


A21 XXxERRORXxxNEGATIVE ADDRESS; NEAR OPERAND COLUMN 08 
U10 XxxERRORXxxUNDEFINED SYMBOL; FELD 


Note 


Flags in conditional instructions or variable definitions within macros 
are only listed if the MTRAC statement is specified. 


The list of error flags together with error identifiers and severity 
codes is contained in Appendix A.5. 
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6.4.6 Monitor Job Variable Support (ΜΟΝΟΝ) 


6.4.6.1 Function 


The software product JV (Job Variables) permits jobs and programs running 
under BS2000 to be controlled and monitored (see "BS2000 Job Variables, 
Reference Manual"). The user defines a so-called monitoring job variable 
that he specifies as an operand of a LOGON, ENTER or EXEC command. The 
operating system enters in this job variable information about the current 
status of a program ("status indicator") as well as other information 
defined on program level ("return indicator"). The user can query this 
information at the end of the program; further jobs and programs may then 
be controlled dependent on this information. 


After a program has been assembled, the monitoring job variable is suppl i ed 
with a return code indicator. 


Since multiple assemblies are allowed, the following applies: 


The monitoring job variable contains the values from that assembly section 
where the highest error weight occurred. 


6.4.6.2 Assembler Indicators 


Return code 
The 4-digit return code stored in the MONJV has the following format: 
TC PI 


TC = Termination code, it may assume the following values: 


ο 0 Normal termination; no warnings or errors occurred. 

Сет? Normal termination; warnings ог class 
WAR/SIG/SER (see below) errors occurred. 

ο. ἐν Abnormal termination; an abort criterion has been reached set by 
the ERR=n/Sm option. 

σ.5" Abnormal termination; a class FAT or a compiler error has been 
identified. 


PI = Program information; it may assume the following values: 


Ст 000° No flags апа по MNOTES reported (-). 

C*001" Reserved 

C'002' Highest error class 0, warnings, WAR. 

C'003* Highest error class 1, significant error, SIG. 
C* 004" Highest error class 2, serious error, SER. 
C*005" Highest error class 3, fatal error, FAT. 
C*006* Compiler error i 
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© Status indicator 
The 3-digit status indicator is set by the assembler as follows: 


- Normal termination C'$T', 
at termination code C'0' or C’1’. 


— Abnormal termination C'$A', 
at termination code C'2' or C'3'. 


6.4.6.3 Potential combinations 


x) In these cases a branch to a job step is made. 


6.6. 6.4 Interdependences 


The MON JV will be supported starting with the assembler \/29. 1С. 
The MONJV will not supported until Version 7.5 of BS2000. In versions 
< 7.5 the termination action of the assembler will remain unchanged. 
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6-5 LASER PRINTER ORIENTED ASSEMBLY LISTING 


The laser printer oriented assembly listing (ND listing) is generated by 
specifying the NDLIST option in the xCOMOPT statement. It differs from the 
standard listing on the following points: 


1. All corrected or deleted source program cards are listed, together with the 
correction statements. 


2. The ND listing is divided into three sections: 


Object code 


Source program 


Additional information 


Object code and source program are identical with the standard listing. 


Additional information consists of: 


6-26 


ISAM key, if the assembled program is contained in an ISAM file and 
SYSDTA was assigned. 


Section names of symbols that represent addresses in instructions. 


OPSYN listing lists the actual mnemonic operation code that was 
changed by means of an OPSYN statement. 


STACK level gives the nesting level for each STACK or UNSTK statement. 
Ux für USING 
where 1 < x < 4 
Px für PRINT 
MTRAC information is output completely. 


Restriction: The value of SETC variables will be printed out up to a 
maximum of 50 characters. 
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© 3. In all cross reference and diagnostic listings the total of statement 
numbers will be increased from 13 to 24 per line. 


The following commands and statements are necessary: 


/SYSFILE SYSLST-QUTFILE 

ZEXEC SASSEMB 

xCOMOPT NDLIST,LINECNT=88 ,SOURCE=/ 

*END 

/SYSFILE SYSDTA=INFILE 

ZR 

ZSYSFILE SYSLST=(PRIMARY) 

ZPRINT OUTFILE,LOOP=JI,FORM=code,CHARS=A7,SPACE=E 


INFILE contains the source program 
OUTFILE contains the ND listing after assembly 
code is the computing center specific parameter that causes 
output to be sent to the laser printer. 6 


© The ND listing is printed from the TSOS.NDFILE with the A7 character set 
and the VFB record: JI (see 3352 Laser Printer Reference Manual). Hith 
88 lines per page, about 40 per cent of paper can be saved. 
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A-l 


Type] Implied 
ment 


C as byte 
needed 

X as 
needed 

B as 
needed 


m 


D double 
word 

L double 

P as byte 
needed 

Z as byte 
needed 

x = 


Я 


SUMMARY OF CONSTANTS 


Length Modi- 


fier Range 


1 to 
256 1) 


1 to 


256 1) 


1 to 256 


1 to 8 


1 to 8 


1 to 8 


1 to 8 


1 to 16 


1 to 4 


Constants 


per 
Operand 


Speci fied 

by 
ae 

hexadecimal multiple 

digits 

binary multiple 

digits 

decimal multiple 

digits 

decimal multiple 

digits 

decimal multiple 

digits 

decimal multiple 

digits 

decimal multiple 

digits 

decimal multiple 

digits 

decimal multiple 

digits 


an absolute 


expression 


multiple 


a relocatable 


or complex 
expression 


relocatable multiple 
symbol 
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Range for 
Exponents 


Summary of constants 


Range for 
Scale 


-187 to *346 


-187 to *346 


0 to 14 


0 to 14 


0 to 28 


Truncation/ 
Padding 
Side 

right 

left 

left 


left 


left 


right 


right 


right 


left 


left 


left 


left 


Al-1 


Summary of constants 


Type| Implied Align Length Modi-| Speci fied Constants} Range for Range for Truncation/ 
Length ment fier Range by per Exponents Scale Padding 
(Bytes) Operand Side 


multiple 
relocatable " 
expression or 
two absolute 
expressions? 
exp (exp) 
multiple left 
a relocatable 
or complex 
relocatable 
expression 


multiple left 
address of an 
external 
dummy section 


(1) in a DS assembly instruction, C and X type constants may have length 
specifications up to 65,535 bytes. 


Note: The duplication factor for DC constants is 65 535, 
for DS constants 16 777 215. 
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A-2 RANGES OF MANTISSAS OF FLOATING-POINT CONSTANTS 


Type| Range of values (exact) Range of values (approximately) 


E 169 < M < (1-16) x 169 
D 1655 < М < (1-16 ^'^ ) x 169 56x10". €M£ 7,2 x 1875 


L 1655 «Ms (1-16 ?? ) x 169 


If the constant is not within the valid range, it is flagged and not stored. 
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- A-3 CHARACTER CODES 


Decimal Hexadeci - EBCDIC Character Set Punch| Printer Graphics 
mal Combination 


0 00 000 00000 | 12,0,9,8,1 
1 01 0000 0001 | 12,9,1 
2 02 0000 0010 | 12,9,2 
3 03 0000 0011 | 12,9,3 
4 04 0000 0100 | 12,9,4 
5 05 0000 0101 | 12,9,5 
6 06 0000 0110 | 12,9,6 
7 07 0000 0111 | 12,9,7 
8 08 0000 1000 | 12,9,8 
9 09 0000 1001 | 12,9,8,1 
10 0A 0000 1010 | 12,9,8,2 
11 0B 0000 1011 | 12,9,8,3 
C 12 0C 0000 1100 | 12,9,8,4 
13 0р 0000 1101 | 12,9,8,5 
14 0E 0000 1110 | 12,9,8,6 
15 OF 0000 1111 | 12,9,8,7 
16 10 0001 0000 | 12,11,9,8,1 
17 11 0001 0001 | 11,9,1 
18 12 0001 0010 | 11,9,2 
19 13 0001 0011 | 11,9,3 
20 14 0001 0100 | 11,9,4 
21 15 0001 0101 | 11,9,5 
22 16 0001 0110 | 11,9,6 
23 17 0001 0111 | 11,9,7 
24 18 0001 1000 | 11,9,8 
25 19 0001 1001 | 11,9,8,1 
26 1A 0001 1010 | 11,9,8,2 
27 1B 0001 1011 | 11,9,8,3 
28 16 0001 1100 | 11,9,8,4 
29 1D 0001 1101 | 11,9,8,5 
30 1Ε 0001 1110 | 11,9,8,6 
31 1Ε 0001 1111 | 11,9,8,7 
32 20 0010 0000 | 11,0,9,8,1 
© 33 21 0010 0001 | 0,9,1 
34 22 0010 0010 | 0,9,2 
35 23 0010 0011 | 0,9,3 
36 24 0010 0100 | 0,9,4 
37 25 0010 0101 | 0,9,5 
38 26 0010 0110 | 0,9,6 
39 27 0010 0111 | 0,9,7 
40 28 0010 1000 | 0,9,8 
41 29 0010 1001 | 0,9,8,1 
42 2A 0010 1010 | 0,9,8,2 
43 2B 0010 1011 | 0,9,8,3 
44 20 0010 1100 | 0,9,8,4 
45 2D 0010 1101 | 0,9,8,5 
46 2E 0010 1110 | 0,9,8,6 
47 2F 0010 1111 | 0,9,8,7 
48 30 0011 0000 | 12,11,0,9,8,1 
49 31 0011 0001 | 9,1 
50 32 0011 0010 | 9,2 
51 33 0011 0011 | 9,3 
52 34 0011 0100 | 9,4 
53 35 0011 0101 | 9,5 
© 54 36 0011 0110 | 9,6 
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55 37 0011 
56 38 0011 
57 39 0011 
58 3A 0011 
59 3B 0011 
60 3C 0011 
61 3D 0011 
62 3E 0011 
63 oF 0011 
64 40 0100 
65 41 0100 
66 42 0100 
67 43 0100 
68 44 0100 
69 65 0100 
70 46 0100 
71 47 0100 
72 48 0100 
73 49 0100 
74 4 0100 
75 4B 0100 
76 4C 0100 
77 4D 0100 
78 4E 0100 
79 4F 0100 
80 50 0101 
81 51 0101 
82 52 0101 
83 53 0101 
84 54 0101 
85 55 ‘| 0101 
86 56 0101 
87 57 0101 
88 58 0101 
89 59 0101 
90 5A 0101 
91 5B 0101 
92 5C 0101 
93 5D 0101 
96 SE 0101 
95 ot 0101 
96 60 0110 
97 61 0110 
98 62 0110 
99 63 0110 
100 64 0110 
101 65 0110 
102 66 0110 
103 67 0110 
104 68 0110 
105 69 0110 
106 6A 0110 
107 6B 0110 
108 6C 0110 
109 6D 0110 
110 6E 0110 
111 6F 0110 
112 70 0111 
113 71 0111 


A3-2 


0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 
1111 
0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 
1111 
0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 
1111 
0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 
1111 
0000 
0001 
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ч  " 9 ` t ὃν 
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ъъ sn 2 * 5 & 
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bt ο we Ὁ b 


` 


` ` ` ` 


` 


o со O O со Сс о O O O OSO O O O ο 


νο we ο ο ο ο nn Ὁ 
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NO UD WR н 


` ` ` ` ` ` 


` 


12,11 


t we ο ъч nn ο» Ὁ 


O οσο Ui δν ω n9 = 


"M O* Ul δω ГУ i xO XO ὢ νο ο 0 xO “о 
` 


Space 


Ω 


p ---- A A 


| ч° — XK @% ° 


1 


x ~ 


y vi 


(cents) 

(period) 

(less than) 

(open parenthesis) 
(plus) 

(vertical) 
(ampersand) 


(exclamation) 
(dollar sign) 
(asterisk) 

(close parenthesis) 
(semicolon) 
(logical NOT) 
(minus) 

(slash) 


(logical AND) 
(comma) 
(percent) 
(underline) 
(greater than) 
(question mark) 
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114 72 0111 0010 12,11,0,9,2 
115 73 0111 0011 12,11,0,9,3 
116 76 0111 0100 12,11,0,9,4 
117 75 0111 0101 12,11,0,9,5 
118 76 0111 0110 12,11,0,9,6 
119 77 0111 0111 12,11,0,9,7 
120 78 0111 1000 12,11,0,9,8 
121 79 0111 1001 | 8,1 
122 7A 0111 1010 | 8,2 š (colon) 
123 7B 0111 1011 | 8,3 # (number sign) 
124 7C 0111 1100 | 8,4 a (at the rate of) 
125 7D 0111 1101 8,5 * (apostrophe) 
126 ’E 0111 1110 | 8,6 = (equals) 
127 ΖΕ 0111 1111 | 8,7 " (quote) 
128 80 1000 0000 12,0,8,1 
129 81 1000 0001 12,0,1 
130 82 1000 0010 12,0,2 
S 151 83 1000 0011 12;0;3 
132 84 1000 0100 12,0,4 
133 85 1000 0101 12,0,5 
134 86 1000 0110 12,0,6 
135 87 1000 0111 12,0,7 
136 88 1000 1000 12,0,8 
137 89 1000 1001 12,0,9 
138 8A 1000 1010 12,0,8,2 
139 8B 1000 1011 12,0,8,3 
140 8с 1000 1100 12,0,8, 6 
141 8D 1000 1101 12,0,8,5 
142 8E 1000 1110 12,0,8,6 
143 8F 1000 1111 | 12,0,8,7 
144 90 1001 0000 12; 33:8; 1 
145 91 1001 0001 32:11, 1 
146 92 1001 0010 i2; 11,4 
147 93 | 1001 0011 de; 11,8 
148 94 1001 0100 12,11,4 
149 95 1001 0101 12,11,5 
150 96 1001 0110 12,11,6 
151 97 1001 0111 i2 11,7 
çS 152 98 1001 1000 12,11,8 
153 99 1001 1001 12,11,9 
154 9A 1001 1010 12, 11,5,2 
155 9B 1001 1011 12,11,8,3 
156 9C 1001 1100 12,11,8,4 
157 9D 1001 1101 ia 11,915 
158 9Ε 1001 1110 12,11,8,6 
159 9F 1001 1111 12,11,8,7 
160 A0 1010 0000 11,0,8,1 
161 A1 1010 0001 11,0, 1 
162 A2 1010 0010 11,0, 2 
163 АЗ 1010 0011 11,0,3 
16% AG 1010 0100 11,0,4 
165 Α5 1010 0101 11,0,5 
166 A6 1010 0110 11,0,6 
167 A7 1010 0111 11,0,7 
168 Α8 1010 1000 11,0,8 
169 A9 1010 1001 11,0,9 
170 AA 1010 1010 11,0,8,2 
171 AB 1010 1011 11,0,8,3 
@ 172 AC 1010 1100 11,0,8,4 
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Decimal Hexadeci - EBCDIC Character Set Punch] Printer Graphics 
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173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
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193 
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195 
196 
197 
198 
199 
200 
201 
202 
203 
20% 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
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224 
225 
226 
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229 
230 
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1010 
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1011 
1011 
1011 
1011 
1100 
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1100 
1100 
1100 
1100 
1100 
1100 
1100 
1100 
1100 
1100 
1100 
1100 
1100 
1101 
1101 
1101 
1101 
1101 
1101 
1101 
1101 
1101 
1101 
1101 
1101 
1101 
1101 
1101 
1101 
1110 
1110 
1110 
1110 
1110 
1110 
1110 


1101 
1110 
1111 
0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
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1010 
1011 
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1101 
1110 
1111 
0000 
0001 
0010 
0011 
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0101 
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1010 
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0000 
0001 
0010 
0011 
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1000 
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1010 
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1110 
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0000 
0001 
0010 
0011 
0100 
0101 
0110 
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231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
246 
245 
246 
247 
© 248 
249 
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251 
252 
253 
254 
255 


N< > 


о Со νου + 0 


(lozenge) 
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S А-а HEXADECIMAL-DECIMAL NUMBER CONVERSION 


1. General 


The table provides for direct conversion of hexadecimal and decimal numbers 
in these ranges: 


Decimal: 
0000 to 4095 


Hexadecimal 
000 to FFF 


2. Hexadecimal Decimal Number Conversion Table 


In the table, the decimal value appears at the intersection of the row 
representing the most significant hexadecimal digits (16? and 16!) and the 
column representing the least significant hexadecimal digit (169. 


Example: C2116 = 310540 


HEX 0 1 2 
ç CO. 3, 3074 

Cl 3088 3089 3090 

C2 3104 3105 3106 


bo UM SI .3124 


For numbers outside the range of the table, add the following values to the 
table figures: 


Hexadecimal Decimal Hexadecimal Decimal 


1000 4,096 C000 49,152 
2000 8,192 D000 53,148 
3000 12,288 E000 57 , 344 
4000 16,384 F000 61,440 
5000 20,480 10000 65,536 
6000 24,576 20000 131,072 
7000 28,672 30000 196,608 
8000 32,768 40000 262,144 
9000 36,864 50000 327,680 
A000 40,960 60000 393,216 
Β000 45,056 Ζ0000 458,752 
ç Example: 102116 = 7201,, 


Hexadecimal Decimal 


C21 3105 
+1000 +4096 
1C21 7201 
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ç A-5 ASSEMBLER ERROR FLAGS 


The assembler will put onlv the letter on a line which contains an error. 

At the end of the assembly, all of the error flags are broken down by letter 
and number, a brief explanation is given, and cross-reference information is 
given for each detailed flag. 


CODE T. E X et Severity 
code 
RELOCATABLE TERM IN PRODUCT OR DIVISION 
COMPLEX-RELOCATABLE EXPRESSION IN EQU-STATEMENT 
EQU-STATEMENT IN XDSECT 
RELOCATABILITY ERROR - NEGATIVE EXPRESSION 


RELOCATABILITY ERROR IN COMPLEX RELOCATABLE 
EXPRESSION 
RELOCATABILITY ERROR 


ADDRESS GREATER THAN 2xx24-1; NEAR OPERAND 
COLUMN NN | 


ΝΕΘΑΤΙΝΕ ADDRESS; ΝΕΑΝ OPERAND COLUMN NN 1 
INVALID OPERAND IN ICTL OR ISEQ STATEMENT 1 
ICTL APPEARS TOO LATE 1 

1 


> 


1 


A10 
A11 
A12 
A14 


1 
1 
1 
1 
1 
1 


> 


x 
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B10 
B11 
1 
B31 
B40 
1 
B42 


Error flags 


(B) 


A5-2 


B44 


B51 


C10 


C20 


C30 


C40 


C51 


C52 


C53 


C54 


C55 


C60 


C61 


C70 


C80 


T € XE Severity 


code 


COPY STATEMENT OPERAND NOT A VALID SYMBOL 


IN MACROLIBRARY PROTO-CALL IS DIFFERENT TO 
ENTRY NAME 


UNEXPECTED EOF ON SYSTEM INPUT 
END STATEMENT READ BEFORE A MEND STATEMENT ΜΑΣ 
ENCOUNTERED 


RECORD TRUNCATED 

ILLEGAL SYMBOLIC PARAMETER; XXXXXXXX 
SYMBOLIC PARAMETER PREVIQUSLY DEFINED 
SOURCE - MACRO HAS BEEN PREVIOUSLY DEFINED; 


ΧΧΧΧΧΧΧΧ 


MACRO INSTRUCTION PROTOTYPE STATEMENT HAS 
INVALID OPCODE 


INVALID FORMAT IN PROTOTYPE PARAMETER; NEAR 
OPERAND COLUMN NN : 

INVALID FORMAT IN MACRO INSTRUCTION 

INVALID FORMAT IN GSEQ STATEMENT 

INCONSISTENT MACRO CALL; NEAR OPERAND COLUMN NN 


INVALID MACRO NAME IN MCALL 


PARAMETER IN MACRO PROTOTYPE OR MACRO INSTRUC- 
TION IS TOO LONG 


= 


OPERAND IN MACRO CALL IS TOO LONG 


POSITIONAL MACRO OPERAND APPEARS AFTER 
KEYWORD OPERAND 


UNDEFINED OR MULTIPLY SPECIFIED KEYWORD 
IN MACRO CALL; XXXXXXXX 


INVALID CONSTANT TYPE 
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| 
| 
| 
| 
| 
| 
; 
| 
| 
: 
| 
I 
| 
| 
] 
: 
| 
| 
| 
| 
| 
| 
x 
| 
x 
| 
| 
| 
| 
| 


Error flags 


$ E XL Severity 


code 


(D) LENGTH MODIFIER ERROR; NEAR OPERAND COLUMN NN 


S-TYPE CONSTANT IN LITERAL STRING 


D4 QUOTES NOT PAIRED OR ILLEGAL TERMINATION OF 
QUOTED STRING 


MISSING OPERAND 


STATEMENT OUT OF SEQUENCE 


D7 REFERENCED ADDRESS ALIGNMENT ERROR; 


NEAR OPERAND COLUMN NN 


SINGLE AMPERSAND OR QUOTE IN STRING; 
NEAR OPERAND COLUMN NN 


INVALID DISPLACEMENT 


D10 INVALID REGISTER SPECIFICATION 
D11 INVALID LENGTH SPECIFICATION; NEAR OPERAND 
COLUMN NN 


D12 DUPLICATION FACTOR ERROR 


D13 SCALE MODIFIER ERROR 


D14 EXPONENT MODIFIER ERROR 


D15 PRECISION LOST - CONSTANT TRUNCATED; NEAR 
OPERAND COLUMN NN 
D16 DATA ITEM OF SELFDEFINING TERM TOO LARGE 


D17 ARITHMETIC OVERFLOW; NEAR OPERAND COLUMN NN 


FLOATING POINT CHARACTERISTIC QUT OF RANGE 


D19 INVALID CHARACTER IN CONSTANT; NEAR OPERAND 
COLUMN NN 


INVALID OPERAND IN Q-CONSTANT 


e 
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Error flags 


A5-4 


(D) 


m 


T E XT 
code 


EXPRESSION OF EQU OPERAND IS NEGATIVE OR 
EXCEEDS 2ж%24-1 


INVALID REGISTER SPECIFICATION - EVEN NUMBERED 
REGISTER REQUIRED 


D31 INVALID REGISTER SPECIFICATION - FLOATING 
POINT REGISTER REQUIRED 


NEAR OPERAND COLUMN NN 


o 
iD 
< 
(D 
2. 
+ 
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Error flags 


FEA T 


Uo 
0 
« 
(D 
^ 
et 
κ 


code 


(E) INVALID SEQUENCE SYMBOL IN GSEQ STATEMENT 


INVALID SYNTAX IN EXPRESSION; NEAR OPERAND 
COLUMN NN 


ARITHMETIC TERM COULD NOT BE SOLVED; NEAR 
OPERAND COLUMN NN 


INVALID SYNTAX IN SPACE OR EJECT STATEMENT 


E33 INVALID USING OR DROP STATEMENT 


E34 DROP ISSUED FOR A REGISTER THAT WAS NOT 
ASSIGNED BY USING STATEMENT 


E40 TOO MANY LEVELS OF PARENTHESES 


E41 MORE THAN 6 LEVELS OF PARENTHESES; NEAR 
OPERAND COLUMN NN 


MISSING RIGHT PARENTHESIS; NEAR OPERAND 
COLUMN NN 


E51 UNPAIRED PARENTHESES OR BLANK FOUND INSIDE 
PAIRED PARENTHESES 


TOO MANY RIGHT PARENTHESES 
INVALID OPERAND IN PRINT OR TITLE STATEMENT; 
NEAR OPERAND COLUMN NN 


INVALID OPERAND IN STACK OR UNSTACK STATEMENT 


= 


E70 INVALID LITERAL USAGE; NEAR OPERAND COLUMN NN 


= 


E71 ILLEGAL LITERAL USAGE; NEAR OPERAND COLUMN NN 


TITLE STATEMENT OPERAND EXCEEDS 100 CHARACTERS 


ILLEGAL STATEMENT OUTSIDE OF MACRO DEFINITION 


ILLEGAL MACRO, MEND OR MEXIT STATEMENT — 
ONLY ALLONED WITHIN MACRO DEFINITION 


a) 


G12 * COMMENT STATEMENT IS ILLEGAL OUTSIDE OF 
MACRO DEFINITION 
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Error flags 


CODE J E Е Severity 
ILLEGAL STATEMENT INSIDE OF MACRO DEFINITION 
OPSYN OR MACRO MAY NOT: APPEAR INSIDE MACRO 
DEFINITION 


(G) 


ISEQ IS ILLEGAL IN COPY CODE 


COLUMN NN 
ADDRESS CONSTANT 
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-- 
2 
Ω. 
(0 


Error flags 


f ÉE 4 Т 
OPERAND 1 OF CNOP MUST BE 0, 2, %, 6 OR 8 
MORE THAN 5 ERRORS IN THIS STATEMENT 


MULTIPLY DEFINED SYMBOL; XXXXXXXX 


WITHIN Α FORESEEABLE SPACE OF TIME 
WITHIN A FORESEEABLE SPACE OF TIME 
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(L) 


= 
ο Uv 
ο o 
а. < 
— Ὁ 0 
zd 
pra 
4 


2 


о 


o 


— —sÓÁ— —] € 


Error flags 


T ER X ü Severity 
code 
(Q) SYMBOL IN ORG OPERAND DOES NOT BELONG TO 
CURRENT SECTION 
9 5 ORG OPERAND IS ABSOLUTE - MUST BE RELOCATABLE Be 
504 SYMBOL NOT PREVIOUSLY DEFINED ОВ ІМ XDSEC m 
k Ж SUBSCRIPT OUT OF RANGE ΤΣ 
m INVALID SUBSCRIPT ded 
S bak: ILLEGAL NAME FIELD adus 
Mac GENERATED NAME FIELD ENTRY IS INVALID Ag“ 


S12 MORE THAN 1 TITLE STATEMENT NAMED 
T T10 GENERATED STRING TOO LONG 
GENERATED FIELD EXCEEDS 255 CHARACTERS 
T12 GENERATED SYMBOL IN NAME FIELD 
EXCEEDS 8 CHARACTERS 


U U10 UNDEFINED SYMBOL; XXXXXXXX 


U11 INVALID ENTRY OPERAND - LINKAGE CANNOT BE 
PERFORMED 


— 
= 
= 


V V10 SET SYMBOL PREVIOUSLY DEFINED 
V20 VARIABLE SYMBOL MATCHES PARAMETER IN SAME 
MACRO DEFINITION 
V30 INCONSISTENT GLOBAL DECLARATION; XXXXXXXX 
V40 ILLEGAL USE OF SYSTEM VARIABLE SYMBOL; XXXXXXX 
V41 SYMBOLIC PARAMETER IN GLOBAL OR LOCAL 


DECLARATION IS SYSTEM VARIABLE SYMBOL; XXXXXXXX 


V42 SYMBOLIC PARAMETER USED IN MACRO PROTOTYPE IS 
SYSTEM VARIABLE SYMBOL; XXXXXXXX 
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———-—————————————— LL 


Error flags 


ТЕ A + Severity 


code 


(V) V43 SYMBOLIC PARAMETER BEGINS WITH RESERVED STRING 


'&SYS' 
V50 INVALID FORMAT FOR VARIABLE SYMBOL 
V51 INVALID USE OF SYSTEM VARIABLE &SYSECT 
V52 INVALID USE OF A DIMENSIONED VARIABLE 
V60 NAME FIELD CONTAINS ILLEGAL SET SYMBOL 
V61 SYMBOL IN NAME FIELD OF OPSYN STATEMENT SHOULD 
© NOT BE CONCATENATED 


ы W10 OPERAND 2 OF SS-INSTRUCTION USES REGISTER 0 FOR 
BASEREGISTER 


OPERAND 2 OF INSTRUCTION IS SELFDEFINING 


SINGLE TERM LOGICAL EXPRESSION IS NOT A SETB 
SYMBOL 


> 


ILLEGAL ATTRIBUTE NOTATION; NEAR OPERAND 
COLUMN NN 


< 
X40 ILLEGAL OPERAND FIELD FORMAT; NEAR OPERAND 
COLUMN NN 


X41 INVALID SEVERITY CODE IN MNOTE STATEMENT 


SYMBOLIC VARIABLE IN CHARACTER STRING 


X43 ARITHMETIC OVERFLOW IN INTERMEDIATE RESULT 
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Error flags 


ον T i 


code 

OPERATOR ERROR IN AIF STATEMENT 

CHARACTER STRING USED AS ARITHMETIC TERM 

CONTAINS NONDECIMAL CHARACTERS 

OPERAND USED IN BOOLEAN RELATION IS NOT BOOLEAN 
X47 OPERAND ERROR IN RELATION 
Y Y10 REFERENCED ADDRESS NOT IN RANGE OF USING 

STATEMENT 

SYMBOL TABLE OVERFLOW 

GLOBAL DIRECTORY OVERFLOW 

LOCAL DIRECTORY OVERFLOW 

ACTR EXCEEDED IN MACRO 

ACTR EXCEEDED IN SOURCE 

ATTRIBUTE LIST OVERFLOW 

LITERAL POOL OVERFLOW 


o 
(D 
< 
@ 
“yj 
et 
< 


(X) 


240 
41 


2 
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Instruction format (SET1) 


A-6 INSTRUCTION FORMAT (SETI) 


Instructions for processors 4004/150, 4004/220, 7.720, 7.730, 7.738, 7.740, 
7.748, 7.750, 7.755, 7.760, 7.762 and all 7.500 


Mnemonic | Instruction Mach. Length| Operand 
Code Name Code Format 
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A Add (word) 5A 4 R1,D2(X2,B2) 
AD Add normalized, long 6A a R1,D2(X2,B2) 
ADR Add normalized, long (register) 2A 2 R1,R2 
AE Add normalized, short 7A a R1,D2(X2,B2) 
AER Add normalized, short (register) 3A 2 R1,R2 
AH Add hal fword 4A 4 R1,D2(X2,B2) 
AL Add logical 5E 6 R1,D2(X2,B2) 
ALR Add logical (register) 1E 2 R1,R2 
AP Add decimal FA 6 D1CL1,B1),D2(L2,B2) 
AR Add (register) 1Α 2 R1,R2 
AU Add unnormalized, short ΖΕ 6 R1,D2(X2,B2) 
AUR Add unnormalized, short (register) 3E 2 R1,R2 
AW Add unnormal ized, long 6E 6 R1,D2(X2,B2) 
AWR Add unnormalized, long (register) 2E 2 R1,R2 
AXR Add normalized, extended 36 2 R1,R2 
BAL Branch and load register 45 4 R1,D2(X2,B2) 
BALR Branch and load register 05 2 R1,R2 
2) BAS Branch and store register 4D 6 R1,D2(X2,B2) 
2)BASR Branch and store register OD e R1,R2 
BC Branch on condition 67 6 I,D2(X2,B2) 
BCR Branch on condition (register) 07 2 I,R2 
BCT Branch on count 46 4 R1,D2(X2,B2) 
BCTR. |Branch on count (register) 06 2 R1,R2 
BXH Branch on index high 86 4 R1,R3,D2(B2) 
BXLE Branch on index low or equal 87 4 R1,R3,D2(B2) 
Ç Compare (word) 59 E R1,D2(X2,B2) 
x ССРО Check CPU AC η D1(B1) ,12 
CD Compare, long 69 4 R1,D2(X2,B2) 
CDR Compare, long (register) 29 2 R1,R2 
CDS Compare double and swap BB 4 R1,R3,D2(B2) 
CE Compare, short 79 4 R1,D2(X2,B2) 
CER Compare, short (register) 39 2 R1,R2 
CH Compare hal fword 49 4 R1,D2(C2,B2) 
© x CIOC Check 1/0 Control AD 4 D1(B1) ,I2 
x CKC Check channel 9F 5 D1(B1) 
CL Compare logical (word) 55 G R1,D2(X2,B2) 
CLC Compare logical D5 6 D1CL,B1),D2(B2) 
CLCL [Compare logical, long OF 2 R1,R2 
CLI Compare logical immediate 95 4 D1(B1),I2 
CLM Compare logical under mask BD E R1,M3,D2(B2) 
CLR Compare logical (register) 15 e R1,R2 
CP Compare decimal F9 6 D1CL1,B1),D2(L2,B2) 
CR Compare (register) 19 2 R1,R2 
CS Compare and swap BA 6 R1,R3,D2(B2) 
CVB Convert to binary 4F E R1,D2(X2,B2) 
CVD Convert to decimal | 4E 4 R1,D2(X2,B2) 
D Divide (word) 5D а R1,D2(X2,B2) 
DD Divide, long 6D E R1,D2(X2,B2) 
DDR Divide, long (register) 2D 2 R1,R2 
DE Divide, short 7D 4 R1,D2(X2,B2) 
DER Divide, short (register) 3D 2 R1,R2 
* DIG Diagnose 83 4 D1(B1) 


Instruction format (SETI) 


Mnemonic 
Code 


A6-2 


Instruction Mach. Length| Operand 
Name Code Format 


Divide decimal 
Divide (register) 
Edit 

Edit and mark 
Execute 

Execute stack 
Function call 


Function call 


Halve, long (register) 

Halt device 

Halve, short (register) 

Insert character 

Insert character under mask 
Idle 

Insert storage key 

Load (word) 

Load address 

Load bit field 

Load complement, long (register) 
Load complement, short (register) 
Load complement 

Load, long 

Load, long (register) 

Load, short 

Load, short (register) 

Load halfword 

Load multiple 

Load negative, long (register) 
Load negative, short (register) 
Load negative 

Load positive, long (register) 
Load positive, short 
Load positive 

Load (word) 

Load and round, extended, 
result long 

Load and round, extended, 
result short 

Load shaded memory 

Load scratch pad 

Load and test, long (register) 
Load and test, short (register) 
Load and test 

Load word indirect 

Multiply (word) 

Multiply, long 

Multiply, long (register) 
Multiply, short 

Multiply, short (register) 
Multiply halfword 

Multiply halfword 

Multiply (register) 

Move 


D1(L1,B1) ,D2(L2,B2) 
R1,R2 
D1(L,B1) ,D2(B2) 
D1(L,B1) ,D2(B2) 
R1,D2(X2,B2) 
R1,M3,D2(B2) 
р1(В1) ,12 

(for 4004/151) 
D1(B1) ‚12 

(for 4004/220-230) 
R1,R2 
D1(B1) 
R1,R2 
R1,D2(X2,B2) 
R1,M3,D2(B2) 
12 
R1,R2 
R1,D2(X2,B2) 
R1,D2(X2,B2) 
B1(D1) ,D3(L3) 
R1,R2 
R1,R2 
R1,R2 
R1,D2(X2,B2) 
R1,R2 
R1,D2(X2,B2) 
R1,R2 
R1,D2(X2,B2) 
R1,R3,D2(B2) 
R1,R2 
R1,R2 
R1,R2 
R1,R2 
R1,R2 
R1,R2 
R1,R2 
R1,R2 


PHD CON CGN P) BW 


i iN rS r N TIO N PO + + NN x 


N 


R1,R2 


D1(L,B1),D2(B2) 
D1(L,B1),D2(B2) 
R1,R2 

R1,R2 

R1,R2 
R1,D2(X2,B2) 
R1,D2(X2,B2) 
R1,D2(X2,B2) 
R1,R2 
R1,D2(X2,B2) 
R1,R2 
R1,D2(X2,B2) 
D1(L1,B1) ,D2(L2,B2) 
R1,R2 

D1(L,B1) ,D2(B2) 


SANA NA roO ANAA A N N с 
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Instruction format (SET1) 


Mnemonic Instruction Mach. Length| Operand 
Code Name Code Format 
OE 


MVCL Move, long 2 R1,R2 
MVI Move immediate | 92 4 D1(B1),12 
MVN Move numerics D1 6 D1(L,B1),D2(B2) 
MVO Move with offset F1 6 D1(L1,B1),D2(L2,B2) 
MVZ Move zones D3 6 D1CL,B1),D2(B2) 
MXD Multiply, extended, result long 67 4 R1,D2(X2,B2) 
MXDR |Multiply, extended, result long 27 2 R1,R2 
MXR Multiply, extended, result short 26 2 R1,R2 
N AND (word) 56 % R1,D2(X2,B2) 
NC AND (characters) D4 6 D1CL,B1),D2(B2) 
NI AND immediate 96 4 D1(B1),12 
NR AND (register) 14 2 R1,R2 
0 OR (word) 56 4 R1,D2(X2,B2) 
OC OR (characters) D6 6 D1C(L,B1),D2(B2) 
OI OR immediate 96 4 D1(B1),12 
OR OR (register) 16 2 R1,R2 
PACK  |Pack F2 6 D1CL1,B1),D2(L2,B2) 
C x PC Program control 82 8 D1(B1) ,I2 
1) POP Pop 9B G R1,R3,D2(B2) 
DPUSH |Push 99 4 R1,R3,D2(B2) A 
x RDD Read direct 85 4 Ρ1(Β1) ,I2 
5 Subtract (word) 5B 4 R1,D2(X2,B2) 
SD Subtract normalized, long 6B 4 R1,D2(X2,B2) 
SDR Subtract normalized, long (register) | 2B 2 R1,R2 
x SDV Start device 9C a D1(B1) 
SE Subtract normalized, short ?B 6 R1,D2(X2,B2) 
SER Subtract normalized, short 3B 2 R1,R2 
(register) 
SH Subtract halfword 4B 4 R1,D2(X2,B2) 
SL Subtract logical 5F 8 R1,D2(X2,B2) 
SLA Shift left single 8B 4 R1,D2(B2) 
SLDA [Shift left double 8F 6 R1,D2(B2) 
SLDL [Shift left double logical 8D 4 R1,D2(B2) 
SLL Shift left single logical 89 4 R1,D2(B2) 
SLR Subtract logical IF 2 R1,R2 
SP Subtract decimal FB 6 D1(L1,B1) ,D2(L2,B2) 
SPM SET program mask 04 2 R1 
SR Subtract (register) 1B e R1,R2 
SRA Shift right single 8A 6 R1,D2(B2) 
© SRDA [Shift right double 8E 4 R1,D2(B2) 
SRDL [Shift right double logical 80 4 R1,D2(B2) 
SRL Shift right single logical 88 < R1,D2(B2) 
SRP Shi ft and round decimal FO 6 D1CL1,B1),D2(B2),13 
x SSK Set storage key 08 2 R1,R2 
* SSM Store shaded memory DA 6 D1(L,B1),D2(B2) 
x SSP Store scratchpad DO 6 D1CL,B1),D2(B2) 
ST Store (word) 50 4 R1,D2(X2,B2) 
DSTBF {Store bit field 81 4 B1(D1) ,D3(L3) 
STC Store character 42 4 R1,D2(X2,B2) 
STCK Store clock B2 4 D1(B1) 
STCM |Store character under mask BE 4 R,M,D(B) 
STD Store, long | 60 4 R1,D2(X2,B2) 
STE Store, short 70 4 R1,D2(X2,B2) 
STH Store hal fword 40 a R1,D2(X2,B2) 
STM Store multiple 90 η R1,R3,D2(B2) 
DSTHI Store word indirect 51 4 R1,D2(X2,B2) 
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Instruction format (SET1) 


Mnemonic 
Code 


X Privileged instruction 
1) Incompatible instruction 


2) Hardware upgrading required 


A6-4 


Instruction Mach. 
Name Code 


Subtract unnormal ized, 
Subtract unnormal ized, 


(register) 
Supervisor call 


Subtract unnormal ized, 
Subtract unnormal ized, 


(register) 


Subtract normalized, extended 


Test device 

Test under mask 
Translate 
Translate and test 
Test and set 
Unpack 

Write direct 
Exclusive OR (word) 


Exclusive OR (characters) 
Exclusive OR immediate 
Exclusive OR (register) 


Zero and add decimal 


Q* n9 +N ON +N +N ON +N Gs OS HH NM 


Length| Operand 


Format 


R1,D2(X2,B2) 
R1,R2 


I 
R1,D2(X2,B2) 
R1,R2 


R1,R2 
D1(B1) 

Ρ1(Β1),12 
D1(L,B1),D2(B2) 
D1(L,B1),D2(B2) 
D1(B1) 
D1(L1,B1),D2(L2,B2) 
D1(BD,I2 
R1,D2(X2,B2) 
D1(L,B1) ,D2(B2) 
D1(B1) ,12 

R1,R2 

D1(L1,B1) ,D2(L2,B2) 
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А-7 INSTRUCTION FORMAT CSET2) 


Instruction format CSET2) 


Additional or alternative instructions for the central processing units in the 
7800 series. 
Generation can be activated via the COMOPT INSTR=SET2 (see section 6.1.1.). 


Mnemonic 
Code 


x CLRCH 
x CLRIO 
x CONCS 
x DISCS 
EPAR 
ESAR 
x1) НОМ 
x HIO 
IAC 
IPK 
x IPTE 
x1) ISK 
x ISKE 
IVSK 
x LASP 
x2)LCTL 
x2) LPSW 


X KXXX 
29 
re 
с 


X K K X * 
o 
— 
a 
"U 


x STCKC 
x2)STCTL 
x STIDC 
x STIDP 
x2) STNSM 
x2) STOSM 


Clear Channel 
Clear I/O 
Connect Channel Set 
Disconnect Channel Set 
Extract primary ASN 
Extract secondary ASN 
Halt Device 
Halt I/O 
Insert Address Space Control 
Insert PSW Key 
Invalidate Page Table Entry 
Insert Storage Key 
Insert Storage Key extended 
Insert virtual Storage Key 
Load Address Space Parameters 
Load Control 
Load PSH 
Load real Address 
Move to primary 
Move to secondary 
Program Call 
Program Transfer 
Purge TLB 
Read direct 
Resume I/O 
Reset Reference Bit 
Reset Reference Bit extended 
Set Address space control 
Set Clock 
Set Clock Comparator 
Signal Processor 
Start 1/0 
Start 1/0 fast release 
Set Ρ5Ν Key from Address 
Set CPU Timer 
Set Prefix 
Set secondary ASN 
Set Storage Key 
Set Storage Key Extended 
Set System Mask 
Store CPU Address 
Store Clock 
Store Clock Comparator 
Store Control 
Store Channel ID 
Store CPU ID 
Store Then and System Mask 
Store Then or System Mask 
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9F01 
9D01 
B200 
B201 
B226 
B227 


«Εν N Ην δ GN GN GN εν GS GS nO δν δν GS GN ον ον NN ον RN NN RN Α ο ο 5 N T ο T T ο T+ NN T ϱν ϱν RR HDHD LH 


Instruction Name Length| Operand Format 
Code 


D2(B2) 
D2(B2) 


no operand 
R1,R2 

R1,R2 

R1,R2 

R1,R2 

D1(B1) ,D2(B2) 
R1,R3,D2(B2) 
D2(B2) 
R1,D2(X2,B2) 
D1CR1,B1),D2(B2) , R3 
D1(R1,B1) ,D2(B2) , R5 
D2(B2) 

R1,R2 

no operand 
D1(B1),I2 
D2(B2) 

D2(B2) 

R1,R2 

D2(B2) 

D2(B2) 

D2(B2) 
R1,R3,D2(B2) 
D2(B2) 


D2(B2) 
R1,R3,D2(B2) 
D2(B2) 
D2(B2) 
D1(B1) ,12 
D1(B1) ,12 


A7-1 


Instruction format (SET2) 


Instruction Mach. Length| Operand 
Name Code Format 


Store CPU Timer D2(B2) 


Mnemonic 


x STPX Store Prefix D2(B2) 

x TB Test Block R1,R2 

x TCH Test Channel D2(B2) 

x TIO Test I/O D2(B2) 

x TPROT [Test Protection D1(B1),D2(B2) 
x3) WRD Write direct D1(B1),I2 


* Privileged instruction 


1) Same mnemonic code as for instruction set SETI 
2) Same machine code as for instruction set SET1 


3) Identical with the instruction with the same name in instruction set SET1 
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ISLU 


C A-8 INTERNAL ASSEMBLY SOURCE LANGUAGE UPDATE ROUTINE CISLU> 


1. Introduction 


The Internal Assembly Source Language Update routine (ISLU) provides the 
user with the capability to store and maintain assembly language source 
programs on magnetic tape and disk. 


Depending on the options chosen, the source programs may be retrieved from 
source library tapes or disk files. An output library tape with standard 


tape labels can be created by this routine, or source programs can be stored 
on disk files (i.e., ISAM or SAM). 


2. Input 
Source Corrections 


C Source corrections may be entered from a disk file, a terminal, or a card 
reader. 


If the corrections are entered on a terminal or retrieved from a disk file, 
it is not necessary for the records to be 80-column card images. If the 

last character in the input record is not a space, an 8-byte sequence 

number is assumed to be present. The input record is reformatted so that the 
sequence number is in columns 73 to 80, and spaces are inserted between the 
end of the remaining data and the sequence number. If the last character of 
the input record is a space, the record is expanded to 80 bytes by adding 
spaces to the right-hand end. 


Source Library File 


A source library tape may have either standard or nonstandard tape labels 
with the linkname equal to BINPUT. However, this routine allows only 
standard labels for the library output tape. BOUTPUT is the output linkname. 


The source library tape may contain a single program or multiple programs 
in any order, but is confined to a single reel. Each program consists of 

C a number of blocks containing from one to five 80-column source statement 
images, preceded by an 80-column xSTARTC image and followed by a tape mark. 
The last program on the tape may be followed by either a standard or 
nonstandard EOF tape label. 


The source file may also reside on a disk as a SAM or ISAM file. All records 
are V-type records and ISAM records must contain an 8-byte key field in the 
first data position. ISAM keys are not considered to be part of the source 
statement, and they are ignored by this source language update facility. 


Source statements do not have to be 80-column card images. If source state- 
ments are less than 80 bytes (i.e., record length less than 84 for SAM and 
less than 92 for ISAM files), the source will be expanded to 80 bytes by 
adding blanks on the right. If the source statement is longer than 80 bytes, 
it will be truncated on the right. When sequence numbers are used, however, 
they must be in columns 73 to 80. 


The linknames for disk input and disk output files are DINPUT and DOUTPUT. 
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5. Output 

Source Librarv Tape 

This tape has the following format 

1. Standard tape labels 

2. 66 -charabtar XSTARTC program identifier block 
3. Source statement blocks, 5 statements per block 
4. Tape mark separating each program 


5. Standard label processing at CLOSE 


Disk Output Files 


A source program may be stored on disk as an ISAM or SAM file. 
The disk files have the following format: 


1. All records are V-type records (84 bytes for SAM and 92 bytes for ISAM) 

2. Only one source program per cataloged file. 

3. ISAM keys starting at 100 with increments of 100. (Note: ISAM keys are 
not connected with the sequence numbers in columns 73 to 80 in any way.) 

Correction Listing 

Corrections made to source programs are always listed. Whenever a source 

statement is replaced, the new statement and the first 38 bytes of the old 

statement are listed. All the deleted old statements are listed also. 


4. Control Statements for ISLU 


Control statements accepted by the Internal Assembly Source Language Update 
Facility are: 


STARTC, DELETE, ENDC 


XSTARTC Statement 


When the source library update facility is desired, a *STARTC control 
statement must be the first statement read from the SYSDTA file. This 
statement can be continued once. Columns 1 through 7 must contain XxSTARTC. 


Operation Operand 


XSTARTC progname, Coption], (SEQ], [number1,[sizel,[id1 
[, INPUT=filenamel[ , OUTPUT=filename] 


All positional operands except progname are optional. A comma must be used to 
denote a missing operand unless no more positional operands follow. The two 
key-word operands, if present, must appear after the positional operands. A 
hyphen (-) is used for continuation provided that it always appears after the 
positional operands and a comma, of after a comma followed by spaces. 
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The continuation statement can start from any column. The program named in the 
XSTARTC statement is always assembled, and the xSTARTC statement from the 
SYSDTA file always replaces the *STARTC statement on the output type or disk 
file. 


progname The program name must be preceded by at least one space and 
can be any combination of characters except space and comma. 
Maximum length is eight characters. 


option This operand may be one of six options as follows: 


1. Unspecified: The source program, which must be in the 
SYSDTA file, is assembled and written to the output tape 
or disk. This option is used for initial creation of the 
source library tape or disk file. The unspecified option 
is indicated on the xSTARTC statement as a null operand. 


2. ADD: All programs on the input tape are copied to the output 
tape, then the program to be added, which must be in the 
SYSDTA file is assembled and written to the output tape. 
Corrections may not be applied. If more than one program 
is to be added, the succeeding programs must use option 1. 
This option is not allowed if any keyword operand is 
speci fied. 


3. ASSEMBLE: The choice of this option permits the specified 
program on the input tape or disk to be assembled with no 
corrections. Neither an output tape nor a disk file is 
created and the *EMDC statement must be omitted. 


4. CORRECT: The source program from the input tape or disk 
is updated with corrections from the SYSDTA file and 
assembled. No output files are created. 


5. COPY: The source program from the input tape or disk is 
updated with corrections from the SYSDTA file, assembled, 
and written to the output tape or disk. No other programs 
from the input tape are processed. 


6. COYPALL: This function is identical to COPY, except that 
(1) all programs on the source library input prior to 
the one to be assembled/corrected are first copied to the 
source output and (2) this option is not allowed if any 
keyword operand is used. 


SEQ Optional, if present, it instructs the assembler to insert 
sequence numbers in the updated source program. 
If this operand is not specified, the contents of columns 73 
through 80 of the source statements or correction statements are 
retained. 


number Optional and should be used only in conjunction with the SEQ 
operand. If SEQ is not specified, the number operand is ignored 
when present. The number operand specifies the first sequence 
number to be assigned in a resequenced output file. If SEQ 
is specified and no number operand is specified, then 100 is 
assumed. Sequence numbers are incremented by 100 in all cases. 
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size This optional field specifies the number of digits in the 
sequence number and must be a value between four and eight. 
For example, if 4 is specified, the sequence number is placed 
in columns 77 through 80. If the field is not specified an 
eight-character field (columns 73 through 80) is assumed. 
If the number of digits specified in the number field exceeds 
that specified by the size filed or the implied size field, 
the rightmost digits of the number field are used. 


id This operand is ignored if the SEQ operand is omitted. This 
operand specifies an identification field that will be inserted 
into all source statements beginning in column 73. If SEFQ is 
used, the id field length is the difference between the maximum 
(8) less the number of characters specified in the size operand. 


INPUT-filename 
This option is used only if the source program is retrieved 
from disk, and filename is the cataloged file which contains 
the source program (i.e., ISAM or SAM) on disk. The linkname 
for disk input files is DINPUT: 


OUTPUT=filename 
This option must be specified if the assembled and corrected 
source program is to be created as a disk file (i.e., ISAM or 
SAM); filename refers to the file which will contain the 
source program. The linkname for disk output is DOUTPUT. 


κΡΕΙΕΤΕ Statement 
Whenever deletion of one or more cards is desired, a *DELETE statement is 


required. *DELETE appears in column 1 through 7 and an optional comma 
may appear in column 8. 


Operation Operand 
xDELETE [,1d1[ ,d21 
d1 Specifies the sequence number of the first card to be deleted 


and begins in column 9. 


d2 Specifies the sequence number of the last card to be deleted 
and must be equal to or greater than dl. 


Progamming Notes: 


1. dl and d2 are any combination of characters except space or comma. 
If the field is greater than eight characters, the rightmost eight 
characters are used. If less than 8 characters, the sequence field is 
right- justified and space-filled to the left. If d2 is omitted, then 
it is set equal do dl. 


2. The comma in column 8 is optional. If present, the next eight characters 
are considered as the dl operand, regardless of their value. 
This option allous deletion of individual statements which contain 
invalid characters in the sequence number field. In order to properly 
position the source tape, a "dummy" correction should be given to the 
preceding statement containing a valid sequence number. 
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© XENDC Statement 


The final control statement of all programs being corrected must be the 
XENDC statement unless the ASSEMBLE option is used. If corrections are 
present, this statement must follow the last correction statement. If no 
corrections are present, it must follow the xSTARTC statement. xENDC appears 
in column 1 through 5. 


Operation Operand 
xENDC [COPY] 
COPY Directs the assembler to copy the remaining programs on the 


source library input tape to the updated source output tape. 
This operand is optional. 


Programming Note: 


C If the xSTARTC statement specifies the CORRECT option, and the COPY 
operand is present in the *ENDC statement, the COPY operand is rejected. 


5. Correction Statements 


Correction statements are identified by exception: that is, if a statement 
does not begin with *STARTC, *DELETE, or *ENDC, it is processed as a 
correction. Correction statements must be in the SYSDTA file in ascending 
order by sequence number (columns 73 through 80). 


Correction statements are divided into two categories: 


Replacement and insertion. If the sequence field of a correction statement 

is equal to the sequence number of a source library statement, then 

the source library statement is replaced by the correction statement. If 

a correction statement has a sequence number that is not equal to the 

sequence number of any statement on the tape, then the statement is inserted 

in proper numerical order. If a correction statement has a space in column 80, 

it is considered to be an insertion and is inserted immediately. Thus, by 

utilizing dummy replacements or insertions to position the input tape, large 
C sections of new coding may be inserted. 
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6. ISLU Messages 


xERRORx dl greater than d2 in d2 is set equal do dl. 
*DELETE statement. 


Option operand in Blank operand assumed. 
XSTARTC statement invalid Rest of statement is ignored. 


ΧΕΚΚΟΚΧ Program to be corrected If COPYALL is used in STARTC, 
FATAL cannot be located on source the source input is copied to 


library input tape. source output. 


NOXENDC 1. No *ENDC statement to Correct and restart. 


terminate statements. 
2. Correction statements 
out of sequence. 


7. Examples: 


l. 


2. 


To use the unspecified option to produce а source librarv tape for а 
program called PROGA from the SYSDTA file. 


xSTARTC PROGRA, ,SEQ 


š | Source input for PROGA 


XENDC 


To use the unspecified option to create a disk file, SAM.FILE.NAME, for 
source program called PROGB from the SYSDTA file. 


XSTARTC PROGB, ,SEQ, OUTPUT=SAM. FILE. NAME 


i | | Source input for PROGB 


*ENDC 


A specific source program called PROGC on input tape to be assembled only 
and another source program called PROGD on the same input tape to be 
assembled and corrected without creating an output tape or disk file. 


XSTARTC PROGC,ASSEMBLE 
XSTARTC PROGD,CORRECT 


Я | Source statements to update PROGD 


XENDC 
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C 6. A disk file whose name is ASM.PROGA.SAM to be assembled and updated, then 
stored back to disk as ASM.PROGA.UPDATE. 


*STARTC PROGA,COPY, INPUT=ASM. PROGA. SAM, - 
OUTPUT=ASM. PROGA. UPDATE 
e | Source statements to update PROGA 


*ENDC 


5. A disk file whose name is ASM.PROGA.INPUT to be assembled, updated and 
stored on disk as an ISAM file named ISAM.PROGA.OUTPUT. 
Because the output file is an ISAM file, the user must issue a FILE 
command for the output file. 
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ç A-9 ASSEMBLER RESTRICTIONS 


The F-Assembler cannot translate arbitrarily large programs. The size of a 
program, the number of symbols, and other limitations must be observed to 
assure a correct translation. The limitations imposed by the assembler are 
detailed below. 


1. Statement Numbers in the Assembly Listing 


In the assembly listing every statement is given a statement number. An 
unlimited number of statements can be translated, but the statement 
numbers are assigned modulo 99999. 


2. Size of Diagnostic File 


A diagnostic file is created when PARAM SAVLIST-ALL or xCOMOPT SAVLST is 

© specified. This file has a capacity of 98303 statements. If it is 
attempted to enter more than this number of statements in the file, the 
F-Assembler issues the error message DIAGNOSTIC FILE OVERFLOW - FILE 
CLOSED and the diagnostic file is closed. 


3. Entries in XREF Listing 


The XREF Listing is limited to 1 000 000 entries. An entry is the number 
of a statement in which a symbol or a macro is defined or invoked. If 

a XREF Listing is requested when the number of entries exceeds 1 000 000, 
the error message XREF TABLE OVERFLOW: XREF AND DIAGNOSTIC LISTING 
INCOMPLETE is issued and only the first 1 000 000 references are printed. 


4. Maximum Number of Symbols 


The maximum number of symbols and macro names depends on the available 
class-6 storage: 


— with 1MB user address space: 10580; 
C — with 2MB user address space: 34900; 
— with user address space »2MB: 43000. 


If more than this number are used, the assembler issues the error message 
"SYMBOL TABLE OVERFLOW - ASSEMBLY TERMINATED' and terminates the translation. 
5. Maximum Number of ESID Numbers 


The assembler can assign a maximum of 2500 ESID numbers. The following 


items are assigned individual ESID numbers: 
\ 


— program sections (Type SD) . 
— common control sections (Type CM) 
— dummy sections (Type DS) 

— external dummy section (Type XD, XR) 
— XDSEC symbols (Type XD, XR) 
— EXTRN symbols (Type ER) 

— WEAK-EXTRN symbols (Type WX) 

— V constants (Type VC) 

— dummy registers (Type DX) 
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restrictions 


Maximum Number of Macro Definitions in the Macro Library 

The macro libraries used by the F-Assembler may contain up to 104000 
macro definitions. 

Maximum Number of macro names in MCALL Statements 


A maximum of 400 macro names can be used in the MCALL statements. 


MCALL Control 


A macro library may comprise macro definitions containing inner macro 
instructions, where these macros are also contained in the library. 


If process switches 0 and 31 are both set, then, in the case of inner 
macro instructions, only those macros are present in the library for the 
F-Assembler whose macro names are explicitly specified in MCALL 


statements in the source program. Only such inner macro instructions can 
be expanded. 


Nesting Depth of Macros 

The maximum nesting depth of the macros is 255. In the assembly listing 
however, only two columns are provided for this. The nesting depth 

is therefore indicated modulo 100. 

Default Values 

Before SET symbols are used, they must be defined. 


Excepted from this requirement are the default values. These can be 
assigned values without first being defined. 


Default values are SET symbols with special names: 


— Global and local SETA symbols having the forms &AGm and &ALm 
respectively, where m is a decimal number between 0 and 99. 


— Global and local SETB symbols having the form &BGn and &BLn 
respectively, where n is a decimal number between 0 and 999. 


— SETC symbols are exclusively global and have the form &CGm, where 
m is a decimal number between 0 and 99. 


11. Length of Input Records 


The assembler accepts input records of lengths up to 128 characters. 
However, only the first 80 bytes are used and further processed, the 
rest of the record has no significance for the F-Assembler. If an 
input record contains more than 128 characters, the error message 


"READ TRUNCATION ERROR IN RDATA MACRO’ 


and then the input record in question are output. The translation is 
then discontinued. 
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çS 12. Operand Length in Macro Instructions 


In Section 4.13.1 it is specified that the maximum length of individual 
operands in macro instructions is 127 characters. However, this is only 
an approximate value. The exact value of the character length of an 
operand can be derived from the internal byte length. The maximum 
internal length for an operand is 240 bytes. 


An operand in a macro instruction can be a 


—  SYSNDX symbol 

— SYSLIST symbol 

— symbolic parameter 
— symbolic operand 
— arithmetic operand 
- character operand 
- composite operand 
— sublist 

- label operand. 


© a) SYSNDX symbol 
Internal length: 3 bytes 
Example: operand &SYSNDX 
length 3 bytes 


b) SYSLIST symbol 


Internal length: 7? bytes 


Example: operand &SYSLIST (3) 
length 7 bytes 
c) Symbolic parameter 


Internal length: 3 bytes 


Example: operand &AAAA 
© length 3 bytes 


d) Symbolic operand 


Form: The operand consists of up to 8 characters, the 
first character being a letter, $, ἃ, or а. 


Internal length: 5 bytes + length of symbol 
Example: operand BBBB 
length 9 bytes. 
e) Arithmetic operand 
Form: The operand is a decimal number of up to 8 digits. 
Internal length: 5-15 bytes, depending on the size of the decimal number. 
Example: operand 3333 


C length 9 bytes. 
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f) Character operand 


Form: 


The operand is a character string other than d) 
or e) (character string > 8 characters). 


Internal length: 6 bytes + length of character string 


Note: 


Example: 


9) Composite operand 


Format: 


Note: 


Example: 


h) Sublist 


Format: 


Note: 


Example: 


i) Keyword operand 


Format: 


Example: 


The operand may contain up to 234 characters. 


operand CCCCCCCCCC 
length 16 bytes. 


An operand can be made up of suboperands of the 
types a), b), c), d), e) and f). The composite 
operand is treated by the F-Assembler as a 
character operand. 


The sum of the internal length of the suboperands 
must not exceed 236 bytes. 


operand AAAA&BB 
length 16 bytes 


5 bytes| Sublist parameters 


The sublist parameters can be of type a), b), c), 
d), e), f), g) or h). 


The sum of the internal lengths of the sublist 


parameters must not exceed 235 bytes. 


operand ( AAAA,BBBB, CCCC) 
length 32 bytes 


2 bytes Keyword parameter 


Keyword parameters can be of type a), b), c), d), 
e), f), 9) or h). | 


The sum of the internal lengths of the keyword 
parameters must not exceed 238 bytes - keyword 
length. 


operand X-AAAA 
length 12 bytes 
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C 13. Global and local Variables 
The maximum number of global and local variables that can be used 
cannot be exactly specified because of the large number of factors 


involved in an estimate. Roughly approximate values are given belou: 


The work areas, VM1 and VM2, are provided for global and local variables. 


GLOBAL DIRECTORY 
° 


νο. DIRECTORY 


ATTRIBUTE LIST 
n 
MACRO WORK AREA 


Starting with Assembler Version 29.0 the sizes of the VM1 and VM2 areas 
depend on the size of class-6 storage and whether the assembler was 
implemented in shareable mode or not. 

The following table summarizes the possible sizes: 


Class-6 memory 


A 


Class-6 memory 


120 KB 120 KB 40 KB 120 KB 120 KB 
136 KB | 26% KB 168 KB 136 KB | 264 KB 


© In the GLOBAL DIRECTORY are stored 


— global SET svmbols 

— local SET symbols defined in the source program 
— sequence symbols defined in the source program 
- GSEQ symbols defined in source program 


In the LOCAL DIRECTORY are stored 

— symbolic parameter 

—  SYSLIST symbols 

— local SET symbols defined in macros 

— sequence symbols defined in macros 

— GSEQ symbols defined in macros. 

In the Attribute List are stored: 

— symbols in the source program whose attributes are accessed 


C — operands of outer macro instructions. 
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In the Macro Work Area are stored 
— current values of global SETC symbols. 


The GLOBAL DIRECTORY belongs to the source program, a LOCAL DIRECTORY is 
assigned to every macro definition. The GLOBAL DIRECTORY, Attribute List 
and macro work area are therefore located in the MV1 or MV2 areas during 
the entire translation of the source program, but the LOCAL DIRECTORY 

is only attached to the GLOBAL DIRECTORY when the associated macro 
instruction is being expanded. This storage area is thereafter not 
required and remains unused until the next macro instruction is 
processed. 


During the expansion of an outer macro containing an inner macro 
instruction, the LOCAL DIRECTORY of the inner macro is attached to that 
of the outer macro for the processing of the inner macro. If the macro 


nesting depth is n, the VM1 area during the expansion of the n-th level 
inner macro can be represented as follous: 


GLOBAL DIRECTORY 
1st LOCAL DIRECTORY 


end LOCAL DIRECTORY 


nth LOCAL DIRECTORY 


The consequences of this organization are as follows: 


VM1 


a) General 


The areas for the GLOBAL DIRECTORY, LOCAL DIRECTORIES, and the 
Attribute List cannot exceed 32 Kbytes, the macro work area is 
limited to 64 Kbytes. 


b) For the VM1 Area 
Problem: 


If a large number of local variables are used, particularly LCLC 
symbols with frequently changing values, and if a high degree of 
nesting occurs in the macros, it is possible that the VM1 area 
overflows. The assembler then issues the error message 

*Z3-LOCAL DICTIONARY OVERFLOW’. 


There are two possibilities: The user can reduce the number of local 
variables, particularly of the LCLC symbols with frequently changing 
values. With some local variables it may be possible to shift to the 
global area. In the case of SETC symbols, more storage space is 
available in the global area than in the local area. The other 
possibility is to reduce the depth of nesting of the macros. 
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C c) For the VM2 Area 
Problem: 


The current values of global SETC symbols are stored in the VM2 area. 
If a large number of GBLC symbols with frequently changing current 
values are used, it is possible that the VM2 area overflows. The 
assembler then issues the error message *Z2-GLOBAL DICTIONARY 
OVERFLOW’. 


Remedy: 


The user must reduce the number of GBLC symbols. In the case of some 
symbols it may be possible to shift to the local area. 
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Ө 4.10 HALSTEAD METRICS 


Complexity metrics of source programs can be output by the assembler. 


The definitions and measurements used are based on a theory developed by 
Maurice H. Halstead. 


The major measurements are: 


Program volume, most compact program volume, program level and programming 
effort. 


These measurements are computed from four metrics: 
— Number of distinct operators 


— Number of distinct operands 


Total number of operators 


— Total number of operands. 


This facility can be activated by COMOPT control using the PROCOM option 
(default: NOPROCOM). 


Description of program complexity metrics: 

In the nonexpanded program the assembler counts 
ml - the number of distinct operators 

m2 - the number of distinct operands 

nl = the total number of operators 

n2 = the total number of operands 

From this we compute: 


ms = ml + m2: The number of distinct program operators and operands, the 
C program vocabulary. 


п: = nl + n2: The total number of operators and operands, the program length. 


vi = n ж 1092 (m): 
The program volume. 
In order to distinguish between m distinct operators and 
operands, at least log2 (m) bits storage are required per 
element. Thus v is the minimum number of bits to be 
allocated to store the program. 


v = 2 (const.): The most compact program volume. 
The smallest possible implementation of any assembly 
program consists of a parameterless macro instruction. 


1: = να/ν: The program level (0«1«-1). 
The program level is defined as the ratio of the most 
compact to the actual volume. The highest level is 1 (the 
level is 1 if there is a macro that corresponds to the 
program). The program level decreases as the actual program 
Ç volume increases. 
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e? = v/1: The programming effort. 
e is the ratio of program volume and program level. 
e increases as the volume increases and the level decreases; 
and e decreases in the other case. 
Definition of operators and operands 
Operators and operands are counted in the unexpanded source program. 
All keywords of the assembler are regarded as "operators". These are: 
— All machine instructions 
— All assembly statements (except for the TITLE, STACK, UNSTK, EJECT, SPACE; 
PRINT, ICTL and ISEQ statements, which merely control the assembly listing 
or the 1/0). 
— The special characters, () + - *x /- " 


— The attributes I, K, L, N, S, T 


— In constants, literals and direct data: the constant types: 
C, X, B, F, H, E, D, L, P, Z, A, Y, S, V and Q and the modifiers L, S and E 


— Each end of statement 
— The boolean operators NOT, AND, OR, EQ, NE, LE, LT, GE and GT. 
Operands are all user-defined lexical elements. These are: 
— Symbolic names, symbolic parameters and sequence symbols 
— Constants, literals, self-defining values and character strings. 
If apostrophes or parentheses are used, everything that is enclosed will 
be considered as an operand unless several values are separated by commas. 
— Macro names, macro operands and keywords 
— Duplication factors, lengths and modifiers 
— Masks 
— Registers 
Only the lexical elements are counted. 
So if, for example, the number 5 occurs as an operand in the source program, 
then no distinction is made whether this is a length, a register or a 
constant. 
If in one position there is a duplication factor 5 and in another the 
register indication 5, both numbers will achieve an increase of m2 by 1, 
and an increase of n2 by 2. | 
Also for operators, e.g. for L, no distinction is made between constant 


type and length attribute. When a count is made, comment lines and notes 
will not be considered. 
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C As a result of the measurements, the program complexity metrics are printed 
at the end of the listing, in the following form: 


UNIQUE OPERATORS M1: n 
UNIQUE OPERANDS M2: n 
USAGE OPERATORS N1: n 
USAGE OPERANDS №: п 
VOCABULARY М: n 
OBSERVED LENGTH N š n 
PROGRAM VOLUME ν n 
PROGRAM LEVEL L 2 n 
PROGRAMMING EFFORT E : n 
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C À-11 EXAMPLES OF DUMMY REGISTERS 


Comments explain the functions of the programs so that further explanations 
need not be given. Note that the method used in Example 1 is appropriate 
for small programs consisting of few CSECTS; for larger programs the dummy 
register vector may be allocated using REQM. Surely, this does not exclude 
the use of Q-type constants and a base register for dummy register 
addressing. In Example 2, the dummy register vector starts at address 
X'1000', the first page allocated for the dummy register vector. 
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10048 GN3 £3 000000 
sHOI TASONNM,9= eg 62€£0605252505393 261000 
czoan3Ssd)V= I8 00000000 861000 
(£93?3Sd, 1*29331Sd, 1* T9331Sd, 1) 19 sa 1ЯЗАҸЅа 6L 23310000 
593151939 AWINQG WNGIAIGNI (€933Sd)0 эа 8832848 SZ 00000000 840000 
AHL 9NISS3HQQV НОУ SHOLO3A H3LSI934 ANWNG (2938840850 за 29328 85 LL 00000000 5430000 
JO SLNVISNOO 3dAL-O dO SNOILLINIJ3Q (193888380 3d 19328285 97 00000000 040000 
8 302 аха 893884 SL 000000 
аму с 0912 аха σ933 59 ἆ 94 000000 
' | SH31SIS3H AWWNG dO SNOILINIJ3G 0119 αχα 193359 > 000000 
x 
"NH3Si9SsnV3OA 33 SVM МІЗ 144181. 3d IZ 89098399 99696084 290000 
‚ *NH31S33A ΙΗΘΙΝ ἸΥ̓ΜΗΌΝΥΝ SNNV3 HOSNSW NI3;2 3d 1X31 04 23S0S99005Sd69S9 360000 
LOO I 13IdSI38 AAGNAWNVADONd xxx I 2а 69 2S2S2S2S2S2S2S2S 690000 
H1SN31 39VSSIN = ,8£,X 10900008800. X σα 89 30900008800 990000 
40 80 ΤΧΗΘΥ͂Ν s 590000 
ES 9 
A-dWnGa Wil %931H33 +G V50000 
W33l съ 280000 
98012188 912188 008 1ПОУМ ж 19 
00089000 50018888 811189 008 o3Jae'x ές 
43 1Ἠ33 “ I3HOVN 1ΠΟΧΜ Sc 520000 
91781 MIVH bZ 33 80 220000 
Czoanasd)?v-*»I1 1 ç 861009 96TV 03 88 310000 
€ 934Sd dO SLN3LNOD 3INOO38 OL .LX3.L. 1X31“(2°09)0 JAW r 360000 360V000c 49 σα 810000 
HOLO3A H31SI93H ANWNG dO 1LHVIS ΟΙ 3ALLV 13H 2 A 12 Ў Ic VI 910000 
5 H31SI 93H ANNNG dO LN3NW3OV' IdSIG - > eH #934540 2 1 0c 930000 940V 02 85 210000 
| 934Sd dO SLN3LNOD 3N0939 OL ‚HIII33ANNM,I=°C2°0T)0 SAW 6T 261000 Υ6ΦΙΥΟΟΟΖ 60 га 200000 
HOLO3A H3SLSID3SY AWWNG dO LYVLS OL 3AILLV 13H τις A 81 Ic VI v00000 
| H31SI 93H ANNNG dO LN3W3OV'IdSIG - > eH 1934540 2 1 ії 030000 330V 02 88 900000 
l33A^HSd*'I v1 8 230000 V30V OT I» 200000 
* 
0Т“* ONISN t I 200000 
0*0I XIVE çT 0V SO 000000 
IM3AYSd АЗЯ1НЯ СІ 230000 
coanasd ΝὰΙΧ3 II 
13489 100348 01 000000 
N390N INIAd 6 
* 8 
SINVISNOO 3dAL-O dO SNVAW АЯ Q3ssaHaav * L 
34V SH3lSI93H ANNNG TVNAIAIGNI эні - ES 9 
Λη S9NIWINVHO5OHd LV ES & 
6438015 аму Q3NIJ3G SI HOLO3A H31SI93H ж $ 
AWWNG HO HNA Эні AIdWVXS SIHLNI - x Š 
i + 
1119489 | dq ld NVX3 HOLO3A H31SI93H XM MMG. 341111 I 
INSWSLVLS 393N0S W INWIS ΖΧΩΩΥ Ίδααν 3409 1923r%O N1301 9V13 
2000 39Vd 10-60-98 29:02:91 LLO3SO L dX ld WVX3 HOLO3A YH3LSI934 ANNNA 


A11-2 


A11-3 


Dummy register examples 


20038 GN3 g1 000000 
H103 '32,2- LT 9898390600 99589009 210000 
( Di3A3Sd)0V- 91 00000000 8T0000 
(293854}0 оа 2928848 bT 00000000 +I0000 
2219 axa 293854 2 000000 
* 

στ du ІІ 44 {0 210000 
, ΗΙΟὰ 33,03 (20220 JAW 01 9109000 VI0%80002 ET σα 200000 
HOLO3A 83191938 ANNNG dO LYVLS ΟΙ 3ALLV 13H 196 dv 6 τσ VI V00000 
e H31SI93H ANWNG 40 LN3A3OV'1aSIG - > cH 29388982 1 8 510000 с109 02 85 900000 
C(1N3A3Sd)V= “Т 1 £ 810000 9104 OT ες 200000 

IN3AYSd N31X3 9 
IT‘* 9NISN S 200000 
OʻTTI ὅἅπνα b 0d SO 000000 
19359 20038 £ 000000 

N39ON lNIšd c 

‚19380 | 31d WAVX3 HOLO3A H31S193H AWWNG. 31111 I 


IN3W3LVIS 393N0S М INWIS TY  I3NGGV 3009 930640 N1901 OVIS 


2000 39Vd 87-20-98 90288261 ZLOASO | X 1dWVX3 HOLO3A 83191938 ANNNA 


e 
e 
ND 
T 
Y 
un 
un 
^s 
табу 
| 
N 
М2 
— 
- 
o 
eo 
* 
с 
N 
> 
— 
Ф 
e 
2 
E 
Ф 
и 
4 
< 


Dummy register examples 


ооа еә 


JOJOSA 
1915168 Awwng 


S}UB}SUOD ejep 
peuyeq 


uJe460Jd 


e vtr io КЖЕ d31V201 
ΗΙΟΝ Lo Р жи ак dies t 
JJ tw эе e ον 
I1 ο 1 
I1393GNNM "NH3 


S395fV3N3OA 33 SYM МІЗ 
l3JISNL'NH31S3]3A LHD 
IN 1VWHONVW SNNV3 HƏ. 
SN3W TTW 


ЕЧ 


"S "NH3S35Ssfnv 
AO A 33 SVM МІЗ 34313 
1“ NH31S33A LHOIN TVW 
HOINVW SNNV3 HOSNSW N 
IZXXXXXXXXXXXXXXX I 
13145133 3GN3WMWV3903 
d ХХХ. 2 2 2 3 2 2 5 3 


999 ө ο 9 EEE DEE 
a 
Ф 


ГЕЧЕ 


CCTV 


prb ^ κάλο adi e 


¿S3uSd 
893880 

L9JYSd 
IV LON 33V 000010 MYHL 24454000 SS334GGV AYOWSW IWNLYIA = 
00000000 [00000000 504040 | 040404505 | 05050505 221000 
g2ç39G6G [058552505 24000000 | 00000000 | 3320V109g 881000 
0002ET2a |τζσντστος 02859108 | OTSS0GSO | 000092ç2 s¥T000 
62£06052 22202222 BVT00000 | 00000000 | 000085955 061000 
6950605) 652505393! 05050505 | 05050505 | 955092675 2/1000 
23521323 53156451 83056089 105231293 | 05506252 891000 
05839999 69608399 808908983 ` 236015253 | 057387979 581000 
6295005£0 I25G82ç2 _SGIO5G05_ 23516012 | 200582€2 — 051000 
_23SGS25G 05506252 F 00000000 00000000 | 00000000 221000 
00000000 00000000 00000000 00000000 600000000 811000 
00000000 00000000 5040404 05050505 05050505 501000 
9025:39ᾳ6ᾳ 058552105 75000000 00000000 59000000 040000 
00000505 05050505 050585510 896592359 192353190 200000 
60905305 60690523 19930580 69890583 99996960 890000 
«36496490 898323260 80830582 80896080 058d 5d 580000 
SIEISATI 5005234561 61122105 8089023280 80500580 —0Vv0000 
69899898 56562626 25252525 989089898 980514095 980000 
€0S696920 23625229 05895080 SIHAHATI 60299060 8/0000 
40059898 38989898 25252525 259969505 00008800 590000 
000060V0 84000000 04050405 50001010 3S0V01S5 080000 
OOZODTVO 00206070 82000000 05050505 5000000 980000 
950V0TS> 0020 0TVO ASVOSSVO 25000000 59000000 820000 
JZ0V0IS4 34650961Y 03825960Y 0002352G T2VT9H0V 510000 
0Z28SV61V 00026020 (I2VI330V 029SVd0V 01150 v8 0 000000 


280000 INNOI-d 


000010:000000 3AV-WA 


,00001,1:,0,1 G 
280000 LV GI3ldn3931NI 
X23334 3333 3323 T 13145138 3GN3WHV39023d XXXXXXXXXXXXx 


TOGNASd 0953 
G3GVOT1 60-98-20/000/T0an3Sd 00Sd & 
100384 GVO1 


κ 


A 
1281 IV 
% (DSW) 


(100 
(100 
(100 
(100 
(100 
(100 
(100 
(100 
(100 
(400) 
(100 
(100) 
(100 
(100 
(100 
(400 
(400 
(400 
(100 
(100 
(400 
(400) 
(400) 
(400) 
(1n0) 
(1n0) 

(NI) 
(100 
(100) 

(NI) 

(NI) 
(100 
(100 

(NI) 
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A11-4 


ee DT аны аа 


m —— 


3 
Ц 
š 
š 
^ 
4 


00069000 


2000 39Vd 


соапз54 
,:N39V34 N3NI3S JGSNW GQNIM HOSN3W NI3,2- 
CLINIANd)V- 


ı 11131839 JIN УЗ 3IG'N3u59VMJ 3nV,2 

‚L13M 311V ΙΗΝΠΧ5ΠΥ 1819 NN39 Η2οαι2 

s N39VS LYOMLNV WHI 113M 3IG NNV3 3IN,I 

a FFFAFA 2 13145139 3T3N3WHKWV3OO? d -erororooreoorexoe 9 
— ыр 


912158 008 1ΠΟΝΜ΄3 
811188 008 озэае* ж 

33 1H34d *SIHOVN 

b1X317 99345 ἆ 
AWWNG OL ç1X31“ç9323Sd 
viva S3AON 21x31 129488 d 
a :N39V33 33NI3S 3GSNW AYIM HOSNAW МІЗ, 33 193884 


850121686 
SOOTESES 


593151999 


(ауа Q31VO9OTIV 151) V - > 8H РА tae 
CLINIAYd DV- 51 
8 AN dx 

01“*% 

0*01 

LINIAUYd 


N390N 


HOLO3A H31SI93H AWWNG 
ΟΙ SS399V НОУ H31S1I93U 3S V8 AHL S3NIJ3G 


“3151999 ASVE HOLO3A H31SI93H ANN. 
V VIA 03193433 SI SH31SIS3t ANNNG IWNGIAIGNI эні ONISS3HQQV - 
`3WILN td ΜΝΝΗΘΟΒά ІУ αΒΙΛΒΗΟΗ8ά SI NOLLV(TIVA3 
'HOLIQ3 39VXNTT13HLA8 (ANILNOY NOLLVZITVILINI 33S) .N3TAHd, 07315 NI 
AN LNA SI SIHL SV HOLO3A H31SI938H ANNNG Эні Зо HLON31 JHL НМ STASWIH 
NH3ONOO LON Q33N H3WIAVHOOHd HL SAY AHOW3IN 9NILS3n03H A8 AWILNNY 
INVHOOHd LV Q3HOIS SI HOLO3A H31SI93H ANNNG эні 3 ld WVX3 SIHL NI ~- 


NYLX3 
19359 
1ΝΤὰ ἆ 


112452 г 31d4WVX3 H31SIS3H AWWNG, 31111 
IN3W3LVLS 323nOS 


817-20-98 9928861 


59388 
89388 
293880 
193884 
* 
Y1X3l 
ΕΙΧ3Ι 
21х31 


YHIVN 
* 
УЗ 1H3d 


£odnasd 


* * N K K N * κ 


W 


990000 
SV0000 
1980000 
230000 


NW1S σὰασαν 


2380899500 58d6989 
00000000 


L919609205925312 
61$522205982£29052 
SASATIZAUYSI6ISA 
9895999696969695 
0900008800 


000000 
000000 
000000 
000000 


930000 


тааау 


LLOASO с ANNA 3319/1938 ANN M 


>20V0009 
£V0V0008 
J20V0008 
v30V0008 


930V 


3009 193790 N1201 9V13 


OV 


S0 


000000 
230000 
830000 
000000 
000000 


000000 


990000 
SV0000 
120000 
150000 
2350000 
2350000 


280000 


220000 
210000 
910000 
010000 
v00000 


200000 
900000 
200000 


000000 
200000 
000000 
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register examples 


2000 39Vd 


LINIAUd 
1. 42 
Add Эні ЗО ΗΙΘΝΞ13ΗΙ 96045 
S3HOLS Y01103 3ΘΥΧΝΙΠ JHL 3H3HM SI SIHL 
30 
A=dund 
21 
8181 
Ш ЗО NOLLWOOTIV ` `` pO 
[] ian 
N HOLO3AH3ISID3H ANWNG . 96094 (2 
JO HLON3T HLIM dONVGHOOOVNI N 1484.8 
азніпозы 93Ώνα Mr JO HASWNN S3NIJ3G 2“@ 
Il “* 
ο΄τι 
N390N 


a NOI1VZITVILINI c 3IdNVX3 Add, 


ана 


Ax 


9N18 f. 
Iva 
19359 
INIAd 
21111 


Ν31Λ84 


* 


* 


1INIAAd 


0I 


4 10 f о r— 00 с 


490000 
090000 
220000 


1N3W31V1S 394005 W INWIS саа Ἱαδσααν 


10-60-98 90:88:91 


10000000 
00010000 
00000000 


28 
33 


¿08 08 
3608 02 
V£0d 05 

Οζ 


000000 
950000 
0%0000 
910000 
2£0000 


220000 
020000 
310000 
010000 
900000 
900000 
$00000 


200000 


200000 
000000 
000000 


3409 193700 N1201 9713 


NOI1VZITVILINI “€ ANNA Atuq 


ZA 
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All-6 


3 
] 
š 
5 
й 
Ё 


HOLIO3A 


43151934 ANWNG 


ό 


93880 


G31V2011V LON 33V 
„ : 39 vd YINIZS 3 00000000 | 


10388 
£O3usd 


033100 SSAYGGV AYOWSW IWALYIA = 


ΠῚ 


000010 NAHL 


 Gaanw qs1M H9SNdW МІЗ 29559532 4 
"N39VS L&OMLNY WHI 1 85505222 
13M 3IG NNV3 3IN^"'1 £$GS09305_ 
13M 311V LANANSAV 18 80899309 
19 N339 H290Gd `l1131S 6915076 
39 JIN 33 3IG ° N39V34 $2720552 

αν ° dB ioo e сеш νι 04954319 
„% „% „% % 99 99 9 ο 9 Φ ο @ o? ө ө Φ ο 00000000 
enn 00000000 
° ο 9 999 9 9.99 9*9 ө ө 5ο 00010000 
Mu co dan Εδώ Кк» 50001010. 
65d 1. E 
********:N39V3J XINI VEOUOERS 
35 aaanW AJIM HOSN3W 89640589 
NI3° ° ° °° 17731829 0960165265 
JIN 33 314 N39V4d 4 05896980 
nV113M 311V LANNXASNV 53198380 
1919 N339 H20Q'N39V 05536969 
S LYOMLNVY WHI 113M 3 230958360 
IG NNVM ZINXXXXXXXXX 69590580 
2 13145139 3AN3WWVA 010754 
OO3d XXXXXXXXXXXXXX 19906020 
ο ө ө ө Φ ө э ө ө ө ө e ооо о 00005700 
FCC 950v 0189 
ee Segen ος 320V015S% 
/ τοι ο... = 


14808970 412609205 |60925062 192230559 | 240100 
52525350 04496069 93058959 |23S5d0S5250 222 | 830100 
19230953 6G9G93ç3 lSd15055d0 [83530282 | 550100 _ 
(62695905 60165112201 05526254 „100000083 | 050100 
G2€0£012 058392561 532de353 190028222 | 220100. 
_ 60592905 32929152 ; 0595630 rds aeg | $10100 
625005650 520552969 2995159 (9196199 " 00100 


00000000 00000000 00000000 00000000 033000 
00000000 00000000 00000000 00000000 891000= 
00000000 00000000 00000000 10000000 581000 
92000000 00006070 84000000 04050404 051000 
ος0α0ῖς» OOLODTVO 0047029820 335216570 221000 
0000070 ντοαυτς» 25090=У6 AL0dOcdS 811000 
22210950 V4S50S8279 1312609205 685285062 501000 
59895490 05996069 940958989 2280890 030000 
01100000 00000585 238080890 23228940 200000 
05605205 89699999 80894919 60990999 890000 
3930959 LEAEATIOH £3902SG3 2229319 440000 
23066060 894905989 89905909 6062/5212 00000 
90938380 12055082 69058380 89940280 2980000 
сат2200у 89698098 298989998 98989898 8/0000 
69692023 69592305 SIHISASI bG5G1960G 590000 
0529852828 38989898 98989898 0282528505 050000 
000060v0 84000000 04040405 +00000Т0 950000 
00109190 asvoesvo 58000000 25000000 820000 
002099049 ο00θ4τσα EVOVOCOS OccddZ20V 4170000 
v30V8908 £22d1891 3950930V 03950760 000000 


000010:000000 3AV-WA 
280000 1Y AI3ldf93331NI 
XXXXXXXXX Ὁ 13145139 30N3WbWV3903d xxx» 
A 
100001,1:,0,1 Gf 28.1 LV 
200038d 0953 X X (095и) 
d 2d VO] 60-98-20/7000/7200NASd 008d & 


coan3Ssd απο] 


(100 
(100 
(100 
(100 
(100 
(100 
(100 
(400 
(400 
(400) 
(100 
(100 
(100) 
(ПО) 
(100 
(400) 
(1n0) 
(1n0) 
(400) 
(1Π0) 
(100 
(100 
(400 
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C ΚΡΡΕΚΕΝΙΡ5 


[11 BS2000 
DMS Tape Processing 
Reference Manual 


Target group 

BS2000 users, assembly language programmers 

(both non-privileged). 

Contents 

Functions of the Data Management System in BS2000; 
DMS commands and macros, service and action macros; 
access methods UPAM, SAM and BTAM for tape files. 
Applications 

BS2000 interactive/batch mode, programming. 


[21 BS2000 
C DMS Disk Processing 


Reference Manual 


Target group 

BS2000 users, assembly language programmers 

(both non-privileged). 

Contents 

Functions of the Data Management System in BS2000; 
DMS commands and macros, service and action macros; 
access methods UPAM, SAM, ISAM and EAM for disk files. 
Applications 

BS2000 interactive/batch mode, programming. 


[5 1 BS2000 
LMS 
Reference Manual 


Target group 
BS2000 users. 


Contents 
6 Description of the statements for creating and managing program 
libraries with LMS. 


Applications 
BS2000 interactive/batch mode. 


[4 ] BS2000 
Executive Macros 
Reference Manual 


Target group 
BS2000 Assembler programmers (non-privileged); system 
administrators. 
Contents 
All Executive macros in alphabetical order with detailed 
explanations and examples; selected macros for DMS and TIAM; 
macro overview according to application areas; comprehensive 
training section dealing with eventing, serialization, inter-task 
communication, contingencies. 
Applications 

© | BS2000 application programs. 
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[5 1 Siemens System 7.000 
Reference Manual and Instruction List 


Target group 
Assembly language programmers. 


Contents 

Description of privileged and non-privileged instructions of the 
CPUs 7.500 and 7.700. 

Description of the functions of these dp systems such as storage 
system, data formats, registers, program execution, processor 
states, dynamic address translation, program interrupt, input- 
output, error handling. 


[6 1 BS2000 
Job Variables 
Reference Manual 


Target group 
BS2000 users. 


Contents 

Applications for job variables in controlling and monitoring jobs 
and program runs; conditional job control; all the necessary 
commands and macros; application examples. 


Applications 
BS2000 timesharing mode. 


[7 1 BS2000 
System Reference Guide 
System User 


Target group 
Experienced BS2000 users. 


Contents 

Survey of 

— commands and macros in BS2000 

— instructions and assembly statements 

— statements for the software products and utility routines 
— ΕΡΤ, EDOR, SORT, LMS, ARCHIVE, PERCON, LEASY 
— TSOSLNK, DCAT, PASSWORD, FDEXIM, FDRIVE, DPAGE, SODUMP, 

TPCOMP2, PRSERVE 

— essential tables and registers of BS2000 

— code tables 

— system standards. 


Applications 
BS2000 interactive/batch mode. 
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Published by Bereich Datentechnik 
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Siemens Aktiengesellschaft 


System Messages 


Reference Manual 


DMS 
Tape Processing 


Reference Manual 


LMS 


Reference Manual 


EDT 
File Editor 


Reference Manual 


Control System 
Command Language 


Reference Manual 


SDF User Commands 


Reference Manual 


Introductory Guide 
for System Users 


User's Guide 


System Standards 


Reference Manual 


Network Access 
for Terminals 


User's Guide 


Datensichtstation * 
9754 

Schnittstelle für 
Programmierer 


Benutzerhandbuch 


Model 9001 Printer 
Programmer's Interface 


User's Guide 


Model 9003 Printer 
Programmer's Interface 


User's Guide 


Model 9004 Printer 
Programmer's Interface 


User's Guide 


Drucker 9013 
Schnittstelle für 
Programmierer 


Benutzerhandbuch 


Systems Standards 


Reference Manual 


DMS 
Disk Processing 


Reference Manual 


ARCHIVE 


Reference Manual 


EDT 


Statement Formats 


Job Variables 


Reference Manual 


SDF System 
Administrator 
Commands 


Reference Manual 


Introductory Guide 
for System Operators 


User's Guide 


DCAM Program 
Interfaces 


Reference Manual 


UTM * 
Planen und Entwerfen 


Beschreibung 


TIAM 


User's Guide 


FHS 


User's Guide 


ASMUS 


User's Guide 


RCOM 


User's Guide 


File Transfer 
in Open Computer 
Networks 


User's Guide 


Teletex-AnschluB — * 
an BS2000 mit TTX-B 


Benutzerhandbuch 


BS2000 


Executive Macros 


Reference Manual 


Utility Routines 


Reference Manual 


EDOR 
File Editing System 


Reference Manual 


AID 
Advanced Interactive 
Debugger 


Reference Manual 


Einführung in SDF * 
für Systemverwaltung 


Beschreibung 


Introductory Guide 
to the 
SDF Dialog Interface 


User's Guide 


DCAM COBOL Calls 


User's Guide 


DCAM Macros 


User's Guide 


UTM, UTM-D 
Distributed Transaction 
Processing 


Reference Manual 


IFG for FHS 


User's Guide 


ASMUS2 


Benutzerhandbuch 


RCOM-S 


Reference Manual 


LEASY 


Reference Manual 


Linkage Editor and 
Loaders 


Reference Manual 


SORT 
Sort/Merge Routine 


Reference Manual 


AID 
Debugging on 
Machine Code Level 


User’s Guide 


SDF-A 


Reference Manual 


Introductory Guide 
to Device Management 


User’s Guide 


UTM 
Generating and 
Administering Applications 


User’s Guide 


RCOM FTP 


Reference Manual 


TRANSDATA 


RFA 


Reference Manual 


PERCON 
Conversion Program 


Reference Manual 


Interactive Debugging 
Aid (IDA) 


Reference Manual 


SDF-A 


Reference Guide 


Connection to 
Packet Switching 
Networks 
(X.25,X.29) 


Reference Manual 


UTM 

Programming 
Applications 
in Pascal-XT 


User’s Guide 


UTM 
Programming 
Applications 
in COBOL 


User’s Guide 


UTM 
Programming 
Applications 
in PL/I 


User’s Guide 


UTM-RPC1 
UTM for RPG Users 


User's Guide 


ADAM 


Reference Manual 


Generation of a 
Data Communication 
System 


User's Guide 


Network Management 
in BS2000 


User's Guide 


NEOSP 


User's Guide 


TDA 


User's Guide 


ADS 


User's Guide 


RBAS 


User's Guide 


OMNIS 


User's Guide 


7 A P BÀ 


MSCF 
Multiprocessor System 


Reference Manual 


SM2 


Reference Manual 


FDDRL 


Reference Manual 


System Installation 


Reference Manual 


Network Management 
in PDN 


User's Guide 


TRASOM 


User's Guide 


RDE 


User's Guide 


Network Management 
Messages, 
Halt Codes 


User's Guide 


OMNIS-PROP 


User's Guide 


Multiprocessors 
Generation, Operation, 
Reconfiguration 


Reference Manual 


Performance 
Handbook 


ELS 
Error Logging System 


Reference Manual 


System Administrator's 
Guide 


Reference Manual 


APS 
Processing 
Instructions 


User's Guide 


COBOL9600 


User's Guide 


BERMUDA 


Reference Manual 


TRINIDAD 


User's Guide 


SPOOL9600 


User's Guide 


TRANSIT-SNA 


Reference Manual 


TRANSIT-CD 


User’s Guide 


Network Management 
Program Interfaces 


User’s Guide 


Service Processor 
TELESERVICE 


Reference Manual 
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